SDK referansı

Puanlar ve depolama

Sayfayı kopyala

Kendi sunucunuz olmadan liderlik tabloları ve üç tür depolama. Bulut depolaması bir oyuncuyu her telefona götürür; cihaz ve güvenli depolama bu cihazda kalır.

#Puanlar

Her uygulamanın bir liderliği vardır. Sadece bir oyuncu'u en iyi skor sayılır.

#Lia.submitScore(score, options)

Bir puan kaydeder. Eğer oyuncuyu yenerse'u en iyi, onun en iyisi olur.

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

Parametre	Tür
`score`	sayı	Bir tamsayı, 0 ile 1,000,000,000,000. Arası. Daha yüksek iyi.
`options.idempotencyKey`	dize	Seçenek (SDK 1.5). Bkz. Tekrar edilebilirlik anahtarları.

Çözülür { best }: oyuncu'u en iyi skor şimdi. Hatalar: bad_score, bad_idempotency_key, not_open.

#Lia.leaderboard()

50,'ın üstü ve bu oyuncunun durumu.

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

Çözülür:

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

name Lia kullanıcı adıdır. Beraberlik, oraya ilk giden kişiye aittir. me dır null oyuncunun bir skoru olana kadar.

#Depolama

	Nerede	Sınırlar	İçin
`Lia.cloudStorage`	Lia's sunucu, her oyuncu için	1024 anahtar, değerler 4096 karaktere kadar	Oyuncuya her telefonla eşlik eden ilerleme ve ayarlar
`Lia.deviceStorage`	Bu oyuncu	5 MB tümü	Önbellekler ve taslaklar
`Lia.secureStorage`	Bu telefon'güvenli depo ( iPhone üzerindeki Anahtarlık)	10 öğe, değerler 2048 karaktere kadar	Token'lar ve sırlar

Her uygulama sadece kendi anahtarlarını görür. Anahtarlar 1 ile 128 harfler, rakamlar, _ ve -; değerler metindir ( JSON ile saklayın JSON.stringify). Kötü anahtarlar ve değerler ile reddedilir bad_key, bad_keys veya bad_value.

#Lia.cloudStorage

Lia üzerinde's sunucu, bu oyuncu için uygulamanızda her telefon üzerinde. Test ve canlı ortaklaşa.

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

Yöntem	Çözülür
`Lia.cloudStorage.setItem(key, value, options)`	`true`. Hata verir `storage_full` 1024 anahtarında.
`Lia.cloudStorage.getItem(key)`	Değer, veya `null`.
`Lia.cloudStorage.getItems(keys)`	Var olan anahtarların ve değerlerinin bir nesnesi. 1 ile 100 anahtarlar.
`Lia.cloudStorage.removeItem(key, options)`	`true`
`Lia.cloudStorage.removeItems(keys, options)`	`true`. 1 dan 100 anahtarlarına.
`Lia.cloudStorage.getKeys()`	Tüm bu oyuncu's anahtarları, sıralanmış şekilde.

Yazmalar, isteğe bağlıdır { idempotencyKey } son (SDK 1.5), bu yüzden eski bir yazının geç bir tekrarı daha yeni bir değeri üzerine yazmaz. Bkz. Tekrar edilebilirlik anahtarları.

Hatalar: not_open (çağrı init() ilk olarak, storage_full, bad_item, bad_keys, bad_idempotency_key.

#Lia.deviceStorage

Sadece bu telefon üzerinde, uygulamanız için. Kişi Lia'ı kaldırırsa veya başka bir telefona geçerse kaybolur.

Yöntem	Çözülür
`Lia.deviceStorage.setItem(key, value)`	`true`. 1,048,576 karaktere kadar değerler; uygulamanın birlikte tuttuğu her şey (anahtarlar ve değerler) 5 MB kadar, veya `storage_full`.
`Lia.deviceStorage.getItem(key)`	Değer, veya `null`.
`Lia.deviceStorage.removeItem(key)`	`true`
`Lia.deviceStorage.clear()`	`true`. Uygulamanızın tümünü kaldırır's anahtarları bu telefonda.

#Lia.secureStorage

Telefonunda'güvenli depo ( iPhone üzerindeki Anahtarlık), uygulamanız için.

Yöntem	Çözülür
`Lia.secureStorage.setItem(key, value)`	`true`. 2048 karaktere kadar değerler; maksimum 10 öğe, veya `storage_full`.
`Lia.secureStorage.getItem(key)`	Değer, veya `null`.
`Lia.secureStorage.removeItem(key)`	`true`
`Lia.secureStorage.clear()`	`true`

Sayfanız'kendi localStorage aynı zamanda çalışır, ama o'Lia'a bağlı'web görünümü ve temizlenebilir; bunları tercih edin.

Otomatik çeviri. İngilizce, doğru kaynaktır. İngilizce olarak oku