挑战排行榜

定义

排行榜是指:开发者在登录开发者管理后台填写相应的排行榜配置,按标准格式要求上报数据后,实现小游戏在分享传播过程中,展现其他玩家参与游戏后成绩排行。

使用步骤说明

  1. 登录开发者管理后台后,在游戏设置-排行榜配置中完成配置
  1. 设置用户分组
  1. 完成规范格式的后台数据上报
  1. 开发者在业务代码中获取数据

获取排行榜数据接口文档: getCloudStorageByRelation

示例

  1. 设置用户分组。groupId的生成完全由开发者决定,需结合开发者自身策略来确保其唯一性。

该步骤必须确保是在上报游戏数据前执行,若在上报数据结果后执行,上报的结果将无法同步更新排行榜数据。

tt.setUserGroup({
  groupId: 'test_group'
})
  1. 按照规范上报游戏数据。

配置了排行榜功能后,排行榜key对应的数据结构需要符合相应规范。详见 KVData

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

tt.setUserCloudStorage({
  KVDataList: [
    // key 需要在开发者后台配置,且配置为排行榜标识后,data 结构必须符合要求,否则会 set 失败
    { key: 'score', value: JSON.stringify(data)  }
  ]
});
  1. 获取用户排行榜数据
tt.getCloudStorageByRelation({
  type: 'group', 
  keyList: ['score'],
  extra: {
    sortKey: 'score',   // 指定的key需要在后台配置过
    groupId: 'test_group'   // 指定要获取的用户所属分组
  },
  success(res){
    console.log(res);
  },
  fail(e){
    console.log('获取数据失败');
  }
})