KVData · 微信小游戲開發API官方文檔

# KVData ### KVData #### 屬性 ##### string key 數據的 key ##### string value 數據的 value #### 將排行榜顯示在小游戲中心若開發者希望把游戲的排行榜顯示于小游戲中心，則需要把排行榜數據存儲到對應的key/value中，一個排行榜數據對應一個key，多個排行榜則多個key。同時在mp.weixin.qq.com的小游戲管理后臺“設置-游戲-排行榜設置”下配置對應的key以及相關排行榜屬性。且value的內容必須是JSON Object格式序列化的字符串，該JSON Object頂層必須包含 `wxgame` 字段，定義如下：屬性名類型必填說明scoreInt32是該榜單對應分數值update\_timeInt64是該分數最后更新時間，Unix時間戳注意： `wxgame`下開發者不可自定義其他字段， `wxgame`同級開發者可自由定義，比如定義一個`detail` 字段，用于存儲取得該分數的中間狀態。 ### 舉例比如某小游戲有一個分數排行榜，分數排行榜需要記錄分數以及獲得分數的耗時（游戲內的排行榜需要展示耗時），可以在`wxgame`同級別定義一個`cost_ms`字段，存儲耗時的毫秒數。分配一個不和已定義的托管數據的key相沖突的key作為分數排行榜的key，如 "score"。在玩家耗時36500ms后，獲得本周最高分16分，則需要更新分數，假設當前時間戳為1513080573，則完整 value在序列化之前的內容如下： ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">{</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> "wxgame": {</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> "score":16,</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> "update_time": 1513080573</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> },</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> "cost_ms":36500</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">}</code></li> </ol> ``` 最終序列化為string后，value為"{"wxgame":{"score":16,"update\_time": 1513080573},"cost\_ms":36500}"。 > 原文: <https://developers.weixin.qq.com/minigame/dev/api/open-api/data/KVData.html>