KVData

托管的 KV 数据

属性

设置排行榜

平台提供了挑战排行榜功能，部分宿主 APP 会在其特有的功能页展示游戏排行数据。开发者若想利用，则需要把排行榜数据存储到对应的 key/value 中，一个排行榜数据对应一个 key，多个排行榜则多个 key。同时在小游戏管理后台“设置-小游戏排行榜设置”下配置对应的 key 以及相关排行榜属性。且 value 的内容必须是 JSON Object 格式序列化的字符串，该 JSON Object 顶层必须包含 ttgame 字段，定义如下：

注意：

1. 使用 setUserCloudStorage 接口设置 KVData 时，当 key 为排行榜 key，则 value 结构必须符合以上要求，否则会设置失败
2. ttgame 下开发者不可自定义其他字段，score 为平台固定使用的排序字段，若开发者想要以某个游戏数据排序，需要将该数据存储在 score 字段上。 ttgame 同级开发者可自由定义，比如定义一个 progress 字段，用于游戏关卡进度。

示例

比如某小游戏有一个分数排行榜，分数排行榜需要记录分数以及获得分数的耗时（游戏内的排行榜需要展示耗时），可以在 ttgame 同级别定义一个 progress 字段，存储耗时的毫秒数。 分配一个不和已定义的托管数据的 key 相冲突的 key 作为分数排行榜的 key，如 "score"。

在玩家游戏结束后，闯过第 10 关，获得本周最高分 100 分，则需要数据，假设当前时间戳为 1557813466 则完整 value 在序列化之前的内容如下：

{
  "ttgame": {
    "score": 100,
    "update_time": 1557813466
  },
  "progress": 10
}

最终序列化为 string 后，value 为 "{"ttgame":{"score":100,"update_time": 1557813466},"progress":36500}"