الدروس
اللعب الجماعي بالدعوة
نسخ الصفحة
غرفة للاعبين اثنين. أنشئها على سيرفرك، وادعُ صديقًا إليها باستخدام مُحدد الأصدقاء في Lia أو رابط، وانزل اللاعبين في نفس الغرفة.
الفكرة: غرفة لها رقم تعريفي، والرقم التعريفي يذهب في الدعوة's startParam. من يفتح الدعوة يفتح تطبيقك بـ startParam هذا، وينضم صفحتك إليهم إلى الغرفة. Lia'مملكتها Lia XO تعمل بهذه الطريقة.
#1. أنشئ غرفة على خادمك
app.post("/api/rooms", async (req, res) => {
const playerId = await playerFrom(req.body.session); // see Verify on your server
if (!playerId) return res.status(401).end();
const room = "room-" + crypto.randomUUID().replace(/-/g, "").slice(0, 10);
await db.createRoom(room, { host: playerId, players: [playerId] });
res.json({ room });
});
app.post("/api/rooms/join", async (req, res) => {
const playerId = await playerFrom(req.body.session);
if (!playerId) return res.status(401).end();
const room = await db.room(req.body.room);
if (!room) return res.status(404).json({ error: "no_room" });
if (room.players.length >= 2 && !room.players.includes(playerId)) return res.status(409).json({ error: "full" });
await db.addPlayer(req.body.room, playerId);
res.json({ room: req.body.room });
});يجب أن تناسب معرفات الغرفة نمط startParam: من 1 إلى 64 من الحروف، الأرقام، _ و -.
#2. دعوة صديق
async function playWithAFriend() {
const { room } = await api("/api/rooms", {});
showWaiting(room);
const { invited } = await Lia.inviteFriend({ startParam: room });
if (!invited) Lia.toast("Share the link to invite someone");
}
// Or a link to send anywhere: opens your app in Lia, or the App Store without it.
async function shareRoom(room) {
await Lia.share("Play with me: " + Lia.inviteLink(room));
}يُحصل كل صديق اخترته على بطاقة في دردشة Lia الخاصة به. Lia يسمح فقط للأشخاص بدعوة أصدقائهم، وأصدقاؤهم فقط من يستطيعون فتح تطبيقك (بينما هو'في الاختبار، فقط مختبراتك).
#3. انتقل إلى الغرفة
اقرأ startParam عندما يفتح تطبيقك، واستمع لوصول واحد أثناءه'تُفتح (يضغط الشخص على دعوة ثانية):
function route(startParam) {
if (startParam && startParam.startsWith("room-")) joinRoom(startParam);
}
Lia.init().then(function () {
route(Lia.startParam);
Lia.ready();
});
Lia.on("startParam", function (data) { route(data.startParam); });
async function joinRoom(room) {
try {
await api("/api/rooms/join", { room });
openTable(room);
} catch (error) {
Lia.toast(error.message === "full" ? "That game is full" : "That game has ended");
}
}يُشير startParam إلى مُرشح فقط: يمكن لأي شخص إنشاء رابط بأي startParam، لذلك يقرر سيرفرك ما إذا كانت الغرفة موجودة واللاعب يمكنه الانضمام.
#4. العب مباشرة
قم بتوصيل اللاعبين 둘 إلى خادمك (عادة ما يكون WebSocket)، وتحقق من كل لاعب'جلسة قبل الانضمام إليها إلى الغرفة. بينما تجري اللعبة:
Lia.enableClosingConfirmation(); // "Leave the game?" if they close
Lia.disableVerticalSwipes(); // a swipe down won't close the sheet mid move
Lia.onPause(function () { socket.send(JSON.stringify({ type: "away" })); });
Lia.onResume(function () { socket.send(JSON.stringify({ type: "back" })); });#5. دورك، بالتنبيه
عندما'شخص ما'حركته وهم'لقد غادروا تطبيقك، هناك إشعار مع الغرفة كـ startParam يعيدهم مباشرة:
{ "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "text": "@kofi played. Your move.", "startParam": "room-a81c2e09f4" }#الجداول العامة
الدعوات هي للأصدقاء. لتمكين أي شخص على Lia من الانضمام، اذكر أيضًا الغرفة في الصالة بينما ينتظر:
// When the room is made: list it (as the host, with one seat taken).
await lia("POST", "/lobby/tables", { tableId: room, hostPlayerId: playerId, seats: 2, taken: 1, title: "Quick game" });
// When someone joins from the lobby: seat them through Lia first (it refuses blocked players and full tables).
app.post("/api/rooms/sit", async (req, res) => {
const playerId = await playerFrom(req.body.session);
if (!playerId) return res.status(401).end();
try {
const { full } = await lia("POST", `/lobby/tables/${encodeURIComponent(req.body.room)}/sit`, { playerId });
await db.addPlayer(req.body.room, playerId);
if (full) startGame(req.body.room);
res.json({ room: req.body.room });
} catch (error) {
res.status(409).json({ error: error.data?.error ?? "failed" }); // full, not_found, own_table
}
});
// When the game starts or the room closes: take it out (safe to repeat).
await lia("DELETE", `/lobby/tables/${encodeURIComponent(room)}`);في صفحتك، عرض الجداول المفتوحة، وقم بجلب الأشخاص الذين اختاروا جدولك في Lia'اللوبي الخاص بهم (يصلون مع startParam lobby-<table id>):
const { tables } = await Lia.lobby.tables();
renderTables(tables, (table) => api("/api/rooms/sit", { room: table.id }));
function route(startParam) {
if (startParam?.startsWith("lobby-")) return api("/api/rooms/sit", { room: startParam.slice(6) }).then(openTable);
if (startParam?.startsWith("room-")) return joinRoom(startParam);
}يمكن للغرباء'ت الدردشة عبر Lia، يتم احترام الكتل، ويمكن لللاعبين التقرير بعضها البعض.
#الحدود التي يجب معرفتها
- يمكن لشخص واحد دعوة 20 صديقًا إلى تطبيقك يوميًا، لذلك تبقى الدعوات شيئًا يرحب به الناس في محادثاتهم.
- يمكن لصاحب الجلسة أن يفتح 3 جداول عامة في تطبيقك في وقت واحد، وتحتفظ القائمة بأقصى حد ساعة.
Lia.inviteFriend()الإجابات{ invited }, أبداً من كان مدعوًا: تتعلم خادمك من كان انضم عندما ينضم.
تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية