KVData

托管的 KV 數(shù)據(jù)

屬性

設(shè)置排行榜

平臺提供了挑戰(zhàn)排行榜功能，部分宿主 APP 會在其特有的功能頁展示游戲排行數(shù)據(jù)。開發(fā)者若想利用，則需要把排行榜數(shù)據(jù)存儲到對應(yīng)的 key/value 中，一個排行榜數(shù)據(jù)對應(yīng)一個 key，多個排行榜則多個 key。同時在小游戲管理后臺“設(shè)置-小游戲排行榜設(shè)置”下配置對應(yīng)的 key 以及相關(guān)排行榜屬性。且 value 的內(nèi)容必須是 JSON Object 格式序列化的字符串，該 JSON Object 頂層必須包含 ttgame 字段，定義如下：

注意：

1. 使用 setUserCloudStorage 接口設(shè)置 KVData 時，當(dāng) key 為排行榜 key，則 value 結(jié)構(gòu)必須符合以上要求，否則會設(shè)置失敗
2. ttgame 下開發(fā)者不可自定義其他字段，score 為平臺固定使用的排序字段，若開發(fā)者想要以某個游戲數(shù)據(jù)排序，需要將該數(shù)據(jù)存儲在 score 字段上。 ttgame 同級開發(fā)者可自由定義，比如定義一個 progress 字段，用于游戲關(guān)卡進度。

示例

比如某小游戲有一個分數(shù)排行榜，分數(shù)排行榜需要記錄分數(shù)以及獲得分數(shù)的耗時（游戲內(nèi)的排行榜需要展示耗時），可以在 ttgame 同級別定義一個 progress 字段，存儲耗時的毫秒數(shù)。 分配一個不和已定義的托管數(shù)據(jù)的 key 相沖突的 key 作為分數(shù)排行榜的 key，如 "score"。

在玩家游戲結(jié)束后，闖過第 10 關(guān)，獲得本周最高分 100 分，則需要數(shù)據(jù)，假設(shè)當(dāng)前時間戳為 1557813466 則完整 value 在序列化之前的內(nèi)容如下：

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

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