SDK справка

Рейтинги и хранилище

Копировать страницу

Таблицы лидеров без собственного сервера, и три вида хранения. Облачное хранение следует за игроком на любой телефон; устройство и безопасное хранение остаются на этом устройстве.

#Рейтинги

У каждого приложения есть одна таблица лидеров. Только игрок'лучший счет считается.

#Lia.submitScore(score, options)

Записывает счет. Если он превосходит игрока'лучший, он становится их лучшим.

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

Параметр	Тип
`score`	число	Целое число, от 0 до 1,000,000,000,000. Чем выше, тем лучше.
`options.idempotencyKey`	строка	Необязательно (SDK 1.5). См. Ключи идемпотентности.

Решается с { best }: игрок'лучший счет теперь. Ошибки: bad_score, bad_idempotency_key, not_open.

#Lia.leaderboard()

Верхние 50, и где находится этот игрок.

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

Решается с:

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

name является Lia именем пользователя. Победитель определяется по тому, кто пришёл первым. me это null пока у игрока нет оценки.

#Хранилище

	Где	Лимиты	Для
`Lia.cloudStorage`	Lia'сервер, на игрока	1024 ключей, значения до 4096 символов	Прогресс и настройки, которые следуют за игроком на любом телефоне
`Lia.deviceStorage`	Этот телефон, для вашего приложения	5 MB везде	Кэши и черновики
`Lia.secureStorage`	Этот телефон'ваш безопасный хранилище (Keychain на iPhone)	10 элементов, значения до 2048 символов	Токены и секреты

Каждое приложение видит только свои ключи. Ключи 1 к 128 букв, цифр, _ и -; значения - это текст (сохраните JSON с JSON.stringify. Плохие ключи и значения отклоняются с bad_key, bad_keys или bad_value.

#Lia.cloudStorage

На Lia'сервер, для этого игрока в вашем приложении, на любом телефоне. Тестовые и живые ключи совместно используются.

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

Метод	Решается с
`Lia.cloudStorage.setItem(key, value, options)`	`true`. Ошибки с `storage_full` в 1024 ключей.
`Lia.cloudStorage.getItem(key)`	Значение, или `null`.
`Lia.cloudStorage.getItems(keys)`	Объект ключей, которые существуют, и их значений. 1 до 100 ключей.
`Lia.cloudStorage.removeItem(key, options)`	`true`
`Lia.cloudStorage.removeItems(keys, options)`	`true`. 1 до 100 ключей.
`Lia.cloudStorage.getKeys()`	Все это игрок'ключи, отсортированные.

Записи принимают необязательный { idempotencyKey } последний (SDK 1.5), поэтому поздняя повторная попытка старой записи никогда не перезапишет более новое значение. См. Ключи идемпотентности.

Ошибки: not_open (вызов init() первым, storage_full, bad_item, bad_keys, bad_idempotency_key.

#Lia.deviceStorage

Только на этом телефоне, для вашего приложения. Пропадет, если человек удалит Lia или перейдет на другой телефон.

Метод	Решается с
`Lia.deviceStorage.setItem(key, value)`	`true`. Значения до 1,048,576 символов; все, что ваше приложение хранит вместе (ключи и значения), до 5 MB, или `storage_full`.
`Lia.deviceStorage.getItem(key)`	Значение, или `null`.
`Lia.deviceStorage.removeItem(key)`	`true`
`Lia.deviceStorage.clear()`	`true`. Удаляет все ваше приложение'ключи на этом телефоне.

#Lia.secureStorage

В телефоне'ваш безопасный хранилище (Keychain на iPhone), для вашего приложения.

Метод	Решается с
`Lia.secureStorage.setItem(key, value)`	`true`. Значения до 2048 символов; до 10 элементов, или `storage_full`.
`Lia.secureStorage.getItem(key)`	Значение, или `null`.
`Lia.secureStorage.removeItem(key)`	`true`
`Lia.secureStorage.clear()`	`true`

Ваша страница'свое localStorage также работает, но это'связано с Lia'веб-просмотр и может быть очищен; предпочитайте их.

Автоматически переведено. Английский — источник истины. Читать на английском