مرجع SDK

الدرجات والتخزين

نسخ الصفحة

الجداول الترتيبية دون خادم خاص بك، وثلاثة أنواع من التخزين. ينتقل التخزين السحابي مع اللاعب إلى أي هاتف؛ والتخزين المحلي والآمن يبقى على هذا الجهاز فقط.

#الدرجات

لكل تطبيق لائحة ترتيب واحدة فقط. فقط لاعب'أفضل نتيجة له تُحسب.

#Lia.submitScore(score, options)

يُسجل درجة. إذا تفوق على اللاعب'أفضل نتيجة له، تصبح أفضل نتيجة له.

const { best } = await Lia.submitScore(1280);

معلمة	النوع
`score`	عدد	عدد صحيح، من 0 إلى 1,000,000,000,000. كلما كان أعلى كان أفضل.
`options.idempotencyKey`	سلسلة	خيار ( SDK 1.5 ). راجع مفاتيح التكرار.

يُحل بـ { best }: اللاعب'أفضل نتيجة له الآن. أخطاء: bad_score, bad_idempotency_key, not_open.

#Lia.leaderboard()

أعلى 50, ومكان هذا اللاعب.

const { top, me } = await Lia.leaderboard();

يُحل بـ:

{
  "top": [
    { "rank": 1, "name": "amara", "score": 4210, "me": false },
    { "rank": 2, "name": "kofi", "score": 3990, "me": true }
  ],
  "me": { "rank": 2, "score": 3990 }
}

name هو اسم المستخدم Lia. تُمنح التصفيات لمن وصل أولًا. me هو null حتى يحصل اللاعب على درجة.

#التخزين

	أين	الحدود	ل
`Lia.cloudStorage`	Lia'خادم، لكل لاعب	1024 مفتاحًا، القيم تصل إلى 4096 حرفًا	التقدم والإعدادات التي تتبع اللاعب إلى أي هاتف
`Lia.deviceStorage`	هذا الهاتف، لتطبيقك	5 MB في كل	الذاكرة المؤقتة والمسودات
`Lia.secureStorage`	هذا الهاتف'المخزن الآمن (مفتاح النظام على iPhone)	10 عنصرًا، القيم تصل إلى 2048 حرفًا	الرموز والسر

كل تطبيق يرى مفاتيحه فقط. المفاتيح هي 1 إلى 128 من الحروف والأرقام، _ و -; القيم هي نص (احفظ JSON مع JSON.stringify). المفاتيح والقيم السيئة تُرفض بـ bad_key, bad_keys أو bad_value.

#Lia.cloudStorage

على Lia'خادم، لهذا اللاعب في تطبيقك، على أي هاتف. اختبار وحقيقي يشتركان فيه.

await Lia.cloudStorage.setItem("progress", JSON.stringify({ level: 7, coins: 120 }));
const progress = JSON.parse((await Lia.cloudStorage.getItem("progress")) ?? "{}");

الطريقة	يُحل بـ
`Lia.cloudStorage.setItem(key, value, options)`	`true`. فشل بـ `storage_full` في 1024 مفاتيح.
`Lia.cloudStorage.getItem(key)`	القيمة، أو `null`.
`Lia.cloudStorage.getItems(keys)`	كائن المفاتيح الموجودة وقيمها. من 1 إلى 100 مفاتيح.
`Lia.cloudStorage.removeItem(key, options)`	`true`
`Lia.cloudStorage.removeItems(keys, options)`	`true`. مفاتيح 1 إلى 100.
`Lia.cloudStorage.getKeys()`	كل هذا اللاعب'مفاتيح، مُرتبة.

الكتابة تأخذ خيارًا { idempotencyKey } الأخير (SDK 1.5)، لذلك لا يُعوّض إعادة محاولة كتابة قديمة بقيمة أحدث. انظر مفاتيح التكرار.

الأخطاء: not_open (استدعاء init() أولاً)، storage_full, bad_item, bad_keys, bad_idempotency_key.

#Lia.deviceStorage

على هذا الهاتف فقط، لتطبيقك. ستختفي إذا قام الشخص بإزالة Lia أو انتقل إلى هاتف آخر.

الطريقة	يُحل بـ
`Lia.deviceStorage.setItem(key, value)`	`true`. القيم تصل إلى 1,048,576 حرفًا؛ كل ما تمسكه تطبيقك معًا (المفاتيح والقيم) يصل إلى 5 MB، أو `storage_full`.
`Lia.deviceStorage.getItem(key)`	القيمة، أو `null`.
`Lia.deviceStorage.removeItem(key)`	`true`
`Lia.deviceStorage.clear()`	`true`. يزيل كل تطبيقك'مفاتيح هذه الهاتف.

#Lia.secureStorage

في الهاتف'المخزن الآمن (مفتاح النظام على iPhone)، لتطبيقك.

الطريقة	يُحل بـ
`Lia.secureStorage.setItem(key, value)`	`true`. القيم تصل إلى 2048 حرفًا؛ حتى 10 عنصرًا، أو `storage_full`.
`Lia.secureStorage.getItem(key)`	القيمة، أو `null`.
`Lia.secureStorage.removeItem(key)`	`true`
`Lia.secureStorage.clear()`	`true`

صفحتك'مملكتها localStorage يعمل أيضًا، لكنه'مرتبطة بـ Lia'متصفح الويب ويمكن حذفه؛ اختر هذه الأشياء.

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