Referência SDK

Pontuações e armazenamento

Copiar página

Rankings sem servidor próprio, e três tipos de armazenamento. O armazenamento em nuvem segue o jogador para qualquer telefone; o armazenamento de dispositivo e seguro fica neste.

#Pontuações

Cada aplicativo tem uma classificação. Apenas um jogador's melhor pontuação conta.

#Lia.submitScore(score, options)

Registra uma pontuação. Se ela superar o jogador's melhor, ela se torna a melhor dela.

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

Parâmetro	Tipo
`score`	número	Um número inteiro, 0 a 1,000,000,000,000. Maior é melhor.
`options.idempotencyKey`	string	Opcional (SDK 1.5). Veja Chaves de idempotência.

Resolve com { best }: o jogador's melhor pontuação agora. Erros: bad_score, bad_idempotency_key, not_open.

#Lia.leaderboard()

Os 50, superiores e onde este jogador está.

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

Resolve com:

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

name é o nome de usuário Lia. Empates vão para quem chegou primeiro. me é null até que o jogador tenha uma pontuação.

#Armazenamento

	Onde	Limites	Para
`Lia.cloudStorage`	Lia'servidor, por jogador	1024 chaves, valores até 4096 caracteres	Progresso e configurações que seguem o jogador para qualquer telefone
`Lia.deviceStorage`	Este telefone, para o seu app	5 MB em todos	Caches e rascunhos
`Lia.secureStorage`	Este telefone'armazenamento seguro (o Keychain no iPhone)	10 itens, valores até 2048 caracteres	Tokens e segredos

Cada aplicativo só vê suas próprias chaves. As chaves são 1 para 128 de letras, dígitos, _ e -; os valores são texto (armazene JSON com JSON.stringify). Chaves e valores incorretos rejeitam com bad_key, bad_keys ou bad_value.

#Lia.cloudStorage

No Lia'servidor, para este jogador no seu aplicativo, em qualquer telefone. Teste e live compartilham-no.

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

Método	Resolve com
`Lia.cloudStorage.setItem(key, value, options)`	`true`. Falha com `storage_full` em 1024 chaves.
`Lia.cloudStorage.getItem(key)`	O valor, ou `null`.
`Lia.cloudStorage.getItems(keys)`	Um objeto das chaves que existem e seus valores. 1 até 100 chaves.
`Lia.cloudStorage.removeItem(key, options)`	`true`
`Lia.cloudStorage.removeItems(keys, options)`	`true`. 1 para 100 chaves.
`Lia.cloudStorage.getKeys()`	Todo este jogador's idioma (desligue com

As escritas tomam um { idempotencyKey } último (SDK 1.5), então um novo tentativa de um escrita antiga nunca sobrescreve um valor mais recente. Veja Chaves de idempotência.

Erros: not_open (chamada init() primeiro), storage_full, bad_item, bad_keys, bad_idempotency_key.

#Lia.deviceStorage

Apenas neste telefone, para o seu app. Desaparece se a pessoa remover Lia ou se mudar para outro telefone.

Método	Resolve com
`Lia.deviceStorage.setItem(key, value)`	`true`. Valores até 1,048,576 caracteres; tudo o que seu app mantém junto (chaves e valores) até 5 MB, ou `storage_full`.
`Lia.deviceStorage.getItem(key)`	O valor, ou `null`.
`Lia.deviceStorage.removeItem(key)`	`true`
`Lia.deviceStorage.clear()`	`true`. Remove todos os seus apps's chaves, ordenadas.

#Lia.secureStorage

No celular'armazenamento seguro (o Keychain no iPhone), para seu aplicativo.

Método	Resolve com
`Lia.secureStorage.setItem(key, value)`	`true`. Valores até 2048 caracteres; até 10 itens, ou `storage_full`.
`Lia.secureStorage.getItem(key)`	O valor, ou `null`.
`Lia.secureStorage.removeItem(key)`	`true`
`Lia.secureStorage.clear()`	`true`

Sua página's próprio localStorage também funciona, mas ele'ligado a Lia'sua visualização da web e pode ser limpa; prefira esses.

Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês