SDK referencia

Puntuaciones y almacenamiento

Copiar página

Tablas de clasificación sin servidor propio, y tres tipos de almacenamiento. El almacenamiento en la nube sigue a un jugador a cualquier teléfono; el almacenamiento en dispositivo y seguro permanece en este.

#Puntuaciones

Cada aplicación tiene un único tablero de clasificación. Solo un jugador's mejor puntaje cuenta.

#Lia.submitScore(score, options)

Registra una puntuación. Si supera al jugador's mejor, se convierte en su mejor.

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

Parámetro	Tipo
`score`	número	Un número entero, 0 a 1,000,000,000,000.. Más alto es mejor.
`options.idempotencyKey`	cadena	Opcional (SDK 1.5). Ver Claves de idempotencia.

Se resuelve con { best }: el reproductor's mejor puntaje ahora. Errores: bad_score, bad_idempotency_key, not_open.

#Lia.leaderboard()

Los primeros 50, y dónde se encuentra este jugador.

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

Se resuelve con:

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

name es el nombre de usuario Lia. Los empates van a quien llegó primero. me es null hasta que el jugador tenga un puntaje.

#Almacenamiento

	Dónde	Límites	Para
`Lia.cloudStorage`	Lia's servidor, por jugador	1024 claves, valores hasta 4096 caracteres	Progreso y configuraciones que siguen al jugador a cualquier teléfono
`Lia.deviceStorage`	Este teléfono, para tu aplicación	5 MB en total	Cachés y borradores
`Lia.secureStorage`	Este teléfono'el almacén seguro (el Keychain en iPhone)	10 elementos, valores hasta 2048 caracteres	Tokens y secretos

Cada aplicación solo ve sus propias claves. Las claves son 1 a 128 de letras, dígitos, _ y -; los valores son texto (almacena JSON con JSON.stringify. Las claves y valores incorrectos se rechazan con bad_key, bad_keys o bad_value.

#Lia.cloudStorage

En Lia's servidor, para este jugador en su aplicación, en cualquier teléfono. Pruebe y en vivo lo comparten.

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

Método	Se resuelve con
`Lia.cloudStorage.setItem(key, value, options)`	`true`. Falle con `storage_full` en 1024 claves.
`Lia.cloudStorage.getItem(key)`	El valor, o `null`.
`Lia.cloudStorage.getItems(keys)`	Un objeto de las claves que existen y sus valores. 1 a 100 claves.
`Lia.cloudStorage.removeItem(key, options)`	`true`
`Lia.cloudStorage.removeItems(keys, options)`	`true`. 1 a 100 claves.
`Lia.cloudStorage.getKeys()`	Todo este jugador's claves, ordenadas.

Las escrituras toman un { idempotencyKey } última (SDK 1.5), por lo que un reintentó tardío de una escritura antigua nunca sobrescribirá un valor más reciente. Véase Claves de idempotencia.

Errores: not_open (llamada init() primero), storage_full, bad_item, bad_keys, bad_idempotency_key.

#Lia.deviceStorage

Solo en este teléfono, para tu app. Se va si la persona elimina Lia o se mueve a otro teléfono.

Método	Se resuelve con
`Lia.deviceStorage.setItem(key, value)`	`true`. Valores hasta 1,048,576 caracteres; todo lo que su aplicación mantiene juntos (claves y valores) hasta 5 MB, o `storage_full`.
`Lia.deviceStorage.getItem(key)`	El valor, o `null`.
`Lia.deviceStorage.removeItem(key)`	`true`
`Lia.deviceStorage.clear()`	`true`. Elimina toda tu aplicación's claves en este teléfono.

#Lia.secureStorage

En el teléfono'el almacén seguro (el Keychain en iPhone), para tu aplicación.

Método	Se resuelve con
`Lia.secureStorage.setItem(key, value)`	`true`. Valores hasta 2048 caracteres; hasta 10 elementos, o `storage_full`.
`Lia.secureStorage.getItem(key)`	El valor, o `null`.
`Lia.secureStorage.removeItem(key)`	`true`
`Lia.secureStorage.clear()`	`true`

Tu página'propio localStorage también funciona, pero es'está vinculado a Lia'su vista web y puede que se borre; prefieren estos.

Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés