Referensi SDK

Skor dan penyimpanan

Salin halaman

Papan peringkat tanpa server milik Anda sendiri, dan tiga jenis penyimpanan. Penyimpanan awan mengikuti pemain ke mana saja; penyimpanan perangkat dan aman tetap di perangkat ini.

#Skor

Setiap aplikasi memiliki satu leaderboard. Hanya pemain'skor terbaik mereka dihitung.

#Lia.submitScore(score, options)

Mencatat skor. Jika melebihi pemain'terbaik, itu menjadi skor terbaik mereka.

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

Parameter	Jenis
`score`	nomor	Sebuah bilangan bulat, 0 hingga 1,000,000,000,000. Semakin tinggi semakin baik.
`options.idempotencyKey`	string	Opsional (SDK 1.5). Lihat Kunci idempotensi.

Menyelesaikan dengan { best }: pemain'skor terbaik sekarang. Kesalahan: bad_score, bad_idempotency_key, not_open.

#Lia.leaderboard()

Papan atas 50, dan di mana pemain ini berada.

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

Menyelesaikan dengan:

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

name adalah username Lia. Kemenangan diberikan kepada siapa yang sampai lebih dulu. me adalah null sampai pemain memiliki skor.

#Penyimpanan

	Di mana	Batasan	Untuk
`Lia.cloudStorage`	Lia'server, per pemain	1024 kunci, nilai hingga 4096 karakter	Progress dan pengaturan yang mengikuti pemain ke ponsel apa pun
`Lia.deviceStorage`	Ponsel ini, untuk aplikasi Anda	5 MB dalam semua	Cache dan draf
`Lia.secureStorage`	Ponsel ini'toko aman (Keychain pada iPhone)	10 item, nilai hingga 2048 karakter	Token dan rahasia

Setiap aplikasi hanya melihat kuncinya sendiri. Kunci-kunci ini 1 ke 128 huruf, angka, _ dan -; nilai-nilainya adalah teks (simpan JSON dengan JSON.stringify). Kunci dan nilai yang salah menolak dengan bad_key, bad_keys atau bad_value.

#Lia.cloudStorage

Di Lia'server, untuk pemain ini di aplikasi Anda, di setiap ponsel. Uji dan hidup berbagi itu.

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

Metode	Menyelesaikan dengan
`Lia.cloudStorage.setItem(key, value, options)`	`true`. Gagal dengan `storage_full` pada 1024 kunci.
`Lia.cloudStorage.getItem(key)`	Nilai, atau `null`.
`Lia.cloudStorage.getItems(keys)`	Sebuah objek dari kunci yang ada dan nilai-nilainya. 1 hingga 100 kunci.
`Lia.cloudStorage.removeItem(key, options)`	`true`
`Lia.cloudStorage.removeItems(keys, options)`	`true`. 1 ke 100 kunci.
`Lia.cloudStorage.getKeys()`	Semua pemain ini'kunci, diurutkan.

Tulisannya mengambil opsional { idempotencyKey } terakhir (SDK 1.5), sehingga retry terlambat dari tulisan lama tidak pernah menimpa nilai yang lebih baru. Lihat Kunci idempotensi.

Kesalahan: not_open (panggil init() pertama), storage_full, bad_item, bad_keys, bad_idempotency_key.

#Lia.deviceStorage

Hanya di ponsel ini, untuk aplikasi Anda. Hilang jika orang tersebut menghapus Lia atau pindah ke ponsel lain.

Metode	Menyelesaikan dengan
`Lia.deviceStorage.setItem(key, value)`	`true`. Nilai hingga 1,048,576 karakter; semua yang aplikasi Anda simpan bersama (kunci dan nilai) hingga 5 MB, atau `storage_full`.
`Lia.deviceStorage.getItem(key)`	Nilai, atau `null`.
`Lia.deviceStorage.removeItem(key)`	`true`
`Lia.deviceStorage.clear()`	`true`. Menghapus semua aplikasi Anda'kunci di ponsel ini.

#Lia.secureStorage

Di ponsel'toko aman (Keychain pada iPhone), untuk aplikasi Anda.

Metode	Menyelesaikan dengan
`Lia.secureStorage.setItem(key, value)`	`true`. Nilai hingga 2048 karakter; hingga 10 item, atau `storage_full`.
`Lia.secureStorage.getItem(key)`	Nilai, atau `null`.
`Lia.secureStorage.removeItem(key)`	`true`
`Lia.secureStorage.clear()`	`true`

Halaman Anda'miliknya localStorage juga bekerja, tapi itu'terkait dengan Lia'tampilan web mereka dan dapat dihapus; lebih baik gunakan ini.

Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris