# 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开始支持