排行榜
您可以在游戏页面上显示个性化的排行榜,展示最佳玩家的成绩和已授权用户在排名中的位置。
为了使以下请求正常工作,请检查开发者控制台中是否已创建排行榜。
提交分数
备注
请求仅对授权用户可用。建议提前进行授权,并且仅当用户提供个人数据时才使用排行榜。
使用动作 Set leaderboard score,并传递以下参数,将新分数发送到排行榜:
Name |
|
排行榜的技术名称。 |
Score |
|
玩家在排行榜中的分数。 |
Additional data |
|
与分数一起发送的可选元数据。 |
例如,提交分数到排行榜可能如下所示:
备注
请求最多每秒发送一次,否则将因错误被拒绝。
建议在发送分数时使用特殊条件 For a postponed event。
排行榜记录
为了显示用户排名,使用循环 For each player in leaderboard 和以下参数:
Name |
|
排行榜的技术名称。 |
Top positions |
|
请求的排行榜顶部记录数量。 |
Request player position |
|
确定是否请求用户的位置。 |
Positions around player |
|
请求用户上方和下方的记录数量。 |
插件通过Yandex Games SDK请求排行榜数据,随后开始循环。此过程需要一些时间。
建议在加载过程中在屏幕上留下一些加载指示。
重要
确保该循环不会一直被调用。建议将其用在函数或触发器内。
在循环内,您将可以访问列表中的表达式:Player 和 Leaderboards 。
排行榜示例
排行榜显示实现示例:
- 显示排行榜前的加载动画。
- 显示分数和名称。
- 显示玩家头像。
- 显示玩家在排行榜中的位置。
已复制