# RankManager.update(Object params)

基础库 3.10.1 开始支持,低版本需做兼容处理

Promise 风格 调用:不支持

# 功能描述

更新分数信息。在发起擂台赛前上报,上报的分数将作为发起擂台赛的擂主分数。在擂台赛中上报,上报的分数将作为擂台赛者的分数,并结束擂台赛弹出结果页。

# 参数

# Object params

入参对象

属性 类型 默认值 必填 说明
scoreKey string 玩法唯一标识,用于区分不同的擂台赛玩法。可以在 MP后台-运营功能管理-基础配置-游戏玩法ID 中配置
score number 分数值
subScoreKey number 可选子 key,正整数,取值范围1-1000。该参数可用于游戏同一玩法的关卡区分,从基础库版本3.12.1开始支持
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

# 示例代码

const rankManager = wx.getRankManager()
// 上报用户分数
rankManager.update({
  scoreKey: 'gameplayone', // 在 MP后台-运营功能管理-基础配置-游戏玩法ID 中配置
  score: 100, // 具体分数值
  success: res => {
  console.log('分数上报成功', res);
  },
  fail: err => {
  console.error('分数上报失败', err);
  },
});

注意事项:

  • subScoreKey 参数从基础库版本3.12.1开始支持
点击咨询小助手