挑戰(zhàn)排行榜

定義

排行榜是指：開發(fā)者在登錄開發(fā)者管理后臺填寫相應(yīng)的排行榜配置，按標(biāo)準(zhǔn)格式要求上報(bào)數(shù)據(jù)后，實(shí)現(xiàn)小游戲在分享傳播過程中，展現(xiàn)其他玩家參與游戲后成績排行。

使用步驟說明

1. 登錄開發(fā)者管理后臺后，在游戲設(shè)置-排行榜配置中完成配置
   
   
2. 設(shè)置用戶分組
   設(shè)置用戶分組接口文檔：tt.setUserGroup
3. 完成規(guī)范格式的后臺數(shù)據(jù)上報(bào)
   上報(bào)接口文檔地址：tt.setUserCloudStorage
4. 開發(fā)者在業(yè)務(wù)代碼中獲取數(shù)據(jù)
   獲取排行榜數(shù)據(jù)接口文檔： tt.getCloudStorageByRelation

示例

1. 設(shè)置用戶分組。groupId的生成完全由開發(fā)者決定，需結(jié)合開發(fā)者自身策略來確保其唯一性。

   該步驟必須確保是在上報(bào)游戲數(shù)據(jù)前執(zhí)行，若在上報(bào)數(shù)據(jù)結(jié)果后執(zhí)行，上報(bào)的結(jié)果將無法同步更新排行榜數(shù)據(jù)。

   tt.setUserGroup({
     groupId: "test_group"
   });

2. 按照規(guī)范上報(bào)游戲數(shù)據(jù)。

配置了排行榜功能后，排行榜 key 對應(yīng)的數(shù)據(jù)結(jié)構(gòu)需要符合相應(yīng)規(guī)范。詳見 KVData

const data = {
  ttgame: {
    score: 16,
    update_time: 1513080573
  },
  cost_ms: 36500
};

tt.setUserCloudStorage({
  KVDataList: [
    // key 需要在開發(fā)者后臺配置，且配置為排行榜標(biāo)識后，data 結(jié)構(gòu)必須符合要求，否則會 set 失敗
    { key: "score", value: JSON.stringify(data) }
  ]
});

3. 獲取用戶排行榜數(shù)據(jù)

   tt.getCloudStorageByRelation({
     type: "group",
     keyList: ["score"],
     extra: {
       sortKey: "score", // 指定的key需要在后臺配置過
       groupId: "test_group" // 指定要獲取的用戶所屬分組
     },
     success(res) {
       console.log(res);
     },
     fail(e) {
       console.log("獲取數(shù)據(jù)失敗");
     }
   });