مرجع SDK
الإشعارات، الدعوات والغرفة الانتظار
نسخ الصفحة
Lia.requestNotifications, Lia.inviteFriend, Lia.inviteLink, Lia.مشاركة و Lia.الغرفة المشتركة.
#الإشعارات
يُرسل خادمك إشعارات باستخدام POST /notifications. صفحة التطبيق تطلب إذنًا فقط. انظر الإشعارات.
#Lia.requestNotifications()
يطلب من الشخص التأكيد، في Lia'ورقته الخاصة، لتمكين تطبيقك من إرسال إشعارات لهم. إذا قاموا بالفعل، فإنه يجيب فوراً دون طلب.
const { allowed } = await Lia.requestNotifications();يُحل بـ { allowed }. Lia.notificationsAllowed يتم تحديثه أيضًا.
| خطأ | متى |
|---|---|
notifications_off | قد لا يرسل تطبيقك إشعارات (قام فريق Lia بإيقافها له). |
busy | آخر من Lia'الشاشات مفتوحة. |
#الدعوات
انظر الدعوات والروابط.
#Lia.inviteFriend(options)
يفتح Lia'مُحدد الأصدقاء. يحصل كل صديق مُحدد على بطاقة في محادثة Lia الخاصة به تفتح تطبيقك بـ startParam الخاص بك. تسمح الورقة أيضًا للشخص بمشاركة رابط دعوتك أينما يريد.
const { invited } = await Lia.inviteFriend({ startParam: "room-k3x9" });| خيار | النوع | |
|---|---|---|
startParam | سلسلة | خياري. 1 إلى 64 من الحروف والأرقام، _ و -. |
idempotencyKey | سلسلة | خيار ( SDK 1.5 ). مع نفس المفتاح، يحصل كل صديق على هذا الدعوة'بطاقة واحدة. انظر مفاتيح التكرار. |
يُحل بـ { invited }: true مرة واحدة تم دعوة أي شخص أو مشاركة الرابط. لا يتعلم تطبيقك أبدًا من هو.
الأخطاء: bad_start_param, bad_idempotency_key, busy.
#Lia.inviteLink(startParam)
تطبيقك'المُعرَّف بعلامة تجارية lialabs.app رابط الإطلاق، مع startParam اختياري. يمكن لأي شخص فتحه: مع Lia، يفتح تطبيقك بـ startParam؛ بدونه، يشير إلى متجر التطبيقات. اتصل به بعد Lia.init().
const link = Lia.inviteLink("room-k3x9");
// "https://your-app.lialabs.app/play?start=room-k3x9"تُرجع سلسلة (ليس بومنسي). تُثير not_ready قبل init() أجاب، و bad_start_param لـ startParam التي لا'لإضاءتها على والانطفاء: أظهر واحدة حيث يمكن أن تبقى لفترة. لا تُحسب أي منهما ضمن الإعلانات الشاشة الكاملة
#Lia.share(text)
يفتح الهاتف'ورقة مشاركة مع نصك، لأي تطبيق على الهاتف. يتم الحل مع null مرة واحدة تُغلق الورقة.
await Lia.share("I scored 1280 in Tilt Runner. Beat me: " + Lia.inviteLink());| معلمة | النوع | |
|---|---|---|
text | سلسلة | حتى 500 حرفًا. |
الأخطاء: bad_text.
#الغرفة الجلوس
الجداول العامة التي يمكن لأي شخص على Lia العثور عليها (SDK 1.6). خادمك يعرضها ويجلس بها؛ انظر الجداول العامة.
#Lia.lobby
#Lia.lobby.tables(options)
الجداول المفتوحة في تطبيقك، الأحدث أولًا. لا تُظهر اللاعب'جداوله الخاصة، سواء كانت كاملة أو منتهية الصلاحية، أو تلك الخاصة بمن حظرهم أو من حظرهم.
const { tables, next } = await Lia.lobby.tables({ stake: 5 });
// [{ id: "t8k2d", game: "your-app", host: { name: "amara" }, seats: 2, taken: 1, title: "Quick game", stake: 5, pot: 0, createdAt, expiresAt }]
const more = next ? await Lia.lobby.tables({ stake: 5, cursor: next }) : null;| خيار | النوع | |
|---|---|---|
stake | عدد | خياري. الجداول فقط في هذا المضاعفة، في LIA (0 لأولئك المجانيين). |
cursor | سلسلة | خياري. next من الصفحة السابقة. |
limit | عدد | خياري. 1 إلى 50, 20 افتراضيًا. |
يُحل بـ { tables, next }: next هو المؤشر للحصول على المزيد، أو null. كل جدول:
| حقل | النوع | |
|---|---|---|
id | سلسلة | الجدول'معرّفها، كما وضّعته خادمك. |
game | سلسلة | تطبيقك'معرّفها. |
host | كائن | { name }: المضيف'س Lia اسم المستخدم. |
seats, taken | عدد | عدد المقاعد الإجمالي، والمقاعد المُستخدمة (المضيف'مُضمنة). |
title | سلسلة أو فارغ | حتى 40 حرفًا. |
stake, pot | عدد | في LIA، كما قام خادمك بإدراجها (لعرضها). |
createdAt, expiresAt | عدد | ملي ثانية منذ 1970. |
للوصول، أرسل الطاولة's id إلى عنوان ويب هوكك، موقّع بسر ويب هوكك. انظر POST /lobby/tables/:id/sit. شخص اختار جدولك في Lia'اللوبي الخاص بهم يصل مع Lia.startParam مُحدد إلى lobby-<table id>: جرّب تعيينهم بنفس الطريقة.
الأخطاء: bad_stake, bad_cursor, bad_session أو الجلسة لم'ت يتم تجديدها)، not_in_lia.
#Lia.lobby.report(playerId, reason, options)
يُبلغ فريق Lia. هم'إنهما ممنوعان أيضًا للشخص الذي يبلغ، لذلك لا يرى أحدهما الآخر'جداولها مرة أخرى.
await Lia.lobby.report("p_3f9c0a6d1b2e4f5a6b7c", "unfair", { tableId: "t8k2d", note: "Left every game when losing" });| معلمة | النوع | |
|---|---|---|
playerId | سلسلة | اللاعب'معرّفها في تطبيقك. |
reason | سلسلة | "name", "unfair", "abuse" أو "other". |
options.tableId | سلسلة | خياري. الجدول الذي حدث فيه. |
options.note | سلسلة | خياري، حتى 300 حرفًا. |
يُحل بـ { reported: true }. الأخطاء: bad_reason, unknown_player, slow_down (أكثر من 20 تقارير في اليوم)، bad_note, bad_tableId.
تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية