المفاهيم

كل لاعب يأتي مسجل الدخول كلاعب لتطبيقك، بـ ID فقط لتطبيقك. تتيح رموز الجلسة لخادمك معرفة من يسأل.

#اللاعبون

الناس لا يسجلون الدخول إلى تطبيقك: يقوم Lia بذلك من أجلهم. عند الفتح الأول لتطبيقك، يقوم Lia بإنشاء حساب لـ لاعب منه. Lia.init() يمنح لك:

{
  "player": { "id": "p_3f9c0a6d1b2e4f5a6b7c", "name": "amara" },
  "session": "lias_eyJhcHAiOi…",
  "exp": 1761998400000,
  "mode": "live"
}

• player.id هو هذه الشخص'معرّفها في تطبيقك. يبقى نفسه كل مرة يفتحونها، على أي هاتف. إنه'الخاصة: إنها'مخصصة فقط لتطبيقك، أبداً حساب Lia الخاص بهم، وتطبيق آخر يحصل على معرّف مختلف لنفس الشخص. استخدمه كمفتاح لكل ما تُخزّنه عن لاعب.
• player.name هو اسم المستخدم الخاص بهم في Lia، دون العلامة @. إنه'عامة ويمكن تغييرها؛ Lia يبقيها محدثة كل مرة يفتح فيها تطبيقك. اعرضها، ولكن لا'لأنك تعرف

لا يمنح Lia تطبيقك شخصًا'البريد الإلكتروني، رقم الهاتف، الرصيد أو أي شيء آخر عن حسابهم.

#الجلسات

يمكن لصفحتك'لإثبات من هو إلى خادمك: يمكن لأي شخص إرسال طلب إلى خادمك يدّعي أنه أي لاعب. لذلك Lia تمنح صفحتك رمز الجلسة, موقعة من قبل Lia، والتي يتحقق منها خادمك باستخدام Lia.

• Lia.init() الإجابات بـ session وعندما تنتهي، exp (مللي ثانية منذ 1970).
• تستمر الجلسة 15 دقائق. احصل على واحد جديد بـ Lia.session() متى ما تحتاجها؛ تجيب { session, exp }.
• تُسمي جلسة تطبيقك، اللاعب والوضع (اختبار أو حي). رمز من تطبيق آخر، من الوضع الآخر أو منتهي الصلاحية غير صالح.

// In your page: send a fresh session with anything your server must trust.
const { session } = await Lia.session();
await fetch("/api/claim", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ session, chargeId }),
});

يُرسل خادمك الرمز إلى POST /session/verify مع مفتاحك السري ويعيد معرّف اللاعب:

{ "valid": true, "playerId": "p_3f9c0a6d1b2e4f5a6b7c", "mode": "live", "exp": 1761998400000 }

#الوضعيات

كل جلسة في الوضع, test أو live, والجميع مفتاح. المفتاح التجريبي يؤكد فقط الجلسات التجريبية، والمفتاح الحي يؤكد الجلسات الحية فقط. راجع اختبار وحقيقي.

#Lia'سجلاته الخاصة عن لاعب

بعض الأشياء Lia يحتفظ بها لكل لاعب في تطبيقك، لذلك لا ت'لديهم حاجة لخادم:

• لهم أفضل نتيجة واضعة على الجدول المتصدر.
• لهم التخزين السحابي: حتى 1024 مفاتيح.
• سواء كانوا سمحت بإشعاراتك.
• لهم الرسوم, المكافآت و شاهد الفيديوهات, والتي يمكن لخادمك البحث عنها.

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