Liaالمطورون

مرجع 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.

تطبيقك'المُعرَّف بعلامة تجارية 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.

تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية

اكتب للبحث في كل صفحة، وطريقة ونقطة نهاية.