挑战排行榜

定义

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

使用步骤说明

  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("获取数据失败");
  }
});
点击纠错