# 排行榜
# 开发
开发排行榜功能,主要是通过关系链数据相关的 API 进行实现。
以分数为排行榜数据为例,可以通过 wx.setUserCloudStorage() 上传当前用户的分数,然后在开放数据域中,通过 wx.getFriendCloudStorage 获取当前用户也玩该小游戏的好友的用户的分数,然后根据数据,自行绘制排行榜界面
由于开放数据域的逻辑是独立的,所以绘制排行榜界面建议使用Layout等轻量级的渲染引擎
# 配置定义
此处配置的排行榜是指:由开发者按标准格式要求数据上报后,在【搜索、社交组件】等微信场景下,可以展现同玩好友的排行榜。
注:该配置只影响【搜索、社交组件】中的排行榜展现。并不影响利用托管数据、主域和开放数据域的方式实现的游戏内好友排行榜。并且【搜索】中展示的条件比较严格,缺少数据不会展示。
# 配置展示场景
该配置影响的场景目前有:微信搜索、社交组件。
- 微信搜索
# 配置步骤与相关字段说明
# 1. 完成规范格式的后台数据上报
上报接口文档地址:wx.setUserCloudStorage (前端接口)、storage.setUserStorage (后台接口)
# 2. 登录 MP 管理后台后,在「游戏能力地图-特色能力-微信排行榜配置」中完成配置
字段 | 说明 |
---|---|
排行榜唯一标识 | 指在后台上报时设置的 key 值,用于识别上报分数 |
排行榜名称 | 如分数排行榜,会在小游戏中心上展示 |
更新周期 | 按照一定周期过滤上报数据。 即每周一过滤刷新用户分数 |
排行榜数据类型 | 用于配置排行榜显示数据类型 整数型:按实际上报的数值显示,如 100,99,98 枚举值:按照上报数值转义后的文本内容显示,如钻石级,黄金级 |
排行榜顺序 | 升序:自小而大,数值小的排行靠前 降序:自大而小,数值大的排行靠前 |
数据单位后缀 | 支持个性化单位,如分、秒、等级等 |