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`	这部手机'的安全存储（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

在手机上'的安全存储（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相关'的网页视图，可能会被清除；优先使用这些。

自动翻译。英语是真实来源。阅读英文