KVData

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

屬性

設(shè)置排行榜

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

注意：

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

示例

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

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

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

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