排行榜

您可以在游戏页面上显示个性化的排行榜,展示最佳玩家的成绩和已授权用户在排名中的位置。

为了使以下请求正常工作,请检查开发者控制台中是否已创建排行榜

提交分数

备注

请求仅对授权用户可用。建议提前进行授权,并且仅当用户提供个人数据时才使用排行榜。

使用动作 Set leaderboard score,并传递以下参数,将新分数发送到排行榜:

Name

string

排行榜的技术名称。

Score

number

玩家在排行榜中的分数。

Additional data

string

与分数一起发送的可选元数据。

例如,提交分数到排行榜可能如下所示:

备注

请求最多每秒发送一次,否则将因错误被拒绝。

建议在发送分数时使用特殊条件 For a postponed event

排行榜记录

为了显示用户排名,使用循环 For each player in leaderboard 和以下参数:

Name

string

排行榜的技术名称。

Top positions

number

请求的排行榜顶部记录数量。

Request player position

boolean

确定是否请求用户的位置。

Positions around player

number

请求用户上方和下方的记录数量。

插件通过Yandex Games SDK请求排行榜数据,随后开始循环。此过程需要一些时间。

建议在加载过程中在屏幕上留下一些加载指示。

重要

确保该循环不会一直被调用。建议将其用在函数或触发器内。

在循环内,您将可以访问列表中的表达式:PlayerLeaderboards

排行榜示例

排行榜显示实现示例:

  • 显示排行榜前的加载动画。
  • 显示分数和名称。
  • 显示玩家头像。
  • 显示玩家在排行榜中的位置。

示例中使用了文本本地化精灵本地化 以及插件自适应文本

下载示例


存储库