SDK référence

Scores et stockage

Copier la page

Classements sans serveur de votre propre, et trois types de stockage. Le stockage en nuage suit un joueur sur n'importe quel téléphone ; le stockage appareil et sécurisé reste sur celui-ci.

#Scores

Chaque application a un classement. Seul un joueur'le meilleur score compte.

#Lia.submitScore(score, options)

Enregistre un score. Si cela bat le joueur'le meilleur, il devient le leur.

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

Paramètre	Type
`score`	nombre	Un nombre entier, de 0 à 1,000,000,000,000. Plus c'est haut, mieux c'est.
`options.idempotencyKey`	chaîne	Optionnel (SDK 1.5). Voir Clés d'idempotence.

Résout avec { best }: le lecteur'le meilleur score maintenant. Erreurs : bad_score, bad_idempotency_key, not_open.

#Lia.leaderboard()

Les 50, supérieurs et où se situe ce joueur.

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

Résout avec :

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

name est le nom d'utilisateur Lia. Les égalités reviennent à celui qui est arrivé en premier. me est null jusqu'à ce que le joueur ait un score.

#Stockage

	Où	Limites	Pour
`Lia.cloudStorage`	Lia'le serveur, par joueur	1024 clés, les valeurs jusqu'à 4096 caractères	Progression et paramètres qui suivent le joueur sur n'importe quel téléphone
`Lia.deviceStorage`	Ce téléphone, pour votre application	5 MB dans l'ensemble	Caches et brouillons
`Lia.secureStorage`	Ce téléphone'le magasin sécurisé (le Keychain sur iPhone)	10 éléments, les valeurs jusqu'à 2048 caractères	Jetons et secrets

Chaque application ne voit que ses propres clés. Les clés sont 1 à 128 de lettres, chiffres, _ et -; les valeurs sont du texte (stockez JSON avec JSON.stringify). Les clés et les valeurs invalides rejettent avec bad_key, bad_keys ou bad_value.

#Lia.cloudStorage

Sur Lia'le serveur, pour ce joueur dans votre application, sur n'importe quel téléphone. Les tests et les versions en direct partagent la même chose.

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

Méthode	Résout avec
`Lia.cloudStorage.setItem(key, value, options)`	`true`. Échoue avec `storage_full` à 1024 clés.
`Lia.cloudStorage.getItem(key)`	La valeur, ou `null`.
`Lia.cloudStorage.getItems(keys)`	Un objet des clés existantes et de leurs valeurs. 1 à 100 clés.
`Lia.cloudStorage.removeItem(key, options)`	`true`
`Lia.cloudStorage.removeItems(keys, options)`	`true`. 1 vers 100 clés.
`Lia.cloudStorage.getKeys()`	Tout ce joueur's langue (désactivez avec

Les écritures prennent un optionnel { idempotencyKey } dernier (SDK 1.5), donc un nouveau test d'une ancienne écriture n'écrase jamais une valeur plus récente. Voir Clés d'idempotence.

Erreurs : not_open (appel init() premier), storage_full, bad_item, bad_keys, bad_idempotency_key.

#Lia.deviceStorage

Uniquement sur ce téléphone, pour votre application. Disparait si la personne supprime Lia ou passe à un autre téléphone.

Méthode	Résout avec
`Lia.deviceStorage.setItem(key, value)`	`true`. Des valeurs jusqu'à 1,048,576 caractères ; tout ce que votre application conserve ensemble (clés et valeurs) jusqu'à 5 MB, ou `storage_full`.
`Lia.deviceStorage.getItem(key)`	La valeur, ou `null`.
`Lia.deviceStorage.removeItem(key)`	`true`
`Lia.deviceStorage.clear()`	`true`. Supprime toutes vos applications's clés, triées.

#Lia.secureStorage

Dans le téléphone'le magasin sécurisé (le Keychain sur iPhone), pour votre application.

Méthode	Résout avec
`Lia.secureStorage.setItem(key, value)`	`true`. Des valeurs jusqu'à 2048 caractères ; jusqu'à 10 éléments, ou `storage_full`.
`Lia.secureStorage.getItem(key)`	La valeur, ou `null`.
`Lia.secureStorage.removeItem(key)`	`true`
`Lia.secureStorage.clear()`	`true`

Votre page'son localStorage fonctionne également, mais il'lié à Lia'vue web et peut être effacé ; préférez ces derniers.

Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais