排行榜
在游戏页面上,您可以展示个性化排行榜(玩家排名表),显示最佳玩家的成绩以及已授权用户在排名中的位置。
要让下述请求正常工作,请检查是否已在开发人员控制台中创建排行榜。
注意
如果在 控制台 的 Technical leaderboard name 字段中没有相应名称的排行榜,请求将返回 404 错误。
提交分数
注意
该请求仅对已授权用户可用。建议提前请求授权,并且仅在用户提供个人数据时才使用排行榜。

使用 Set leaderboard score 操作向排行榜提交新分数,参数如下:
|
参数 |
类型 |
描述 |
|
Name |
|
排行榜的技术名称。 |
|
Score |
|
玩家在排行榜中的分数。 |
|
Additional data |
|
随分数一起发送的可选元数据。 |
例如,向排行榜提交分数可以如下所示:

备注
排行榜条目
要开始使用排行榜,请将 Fetch leaderboard 操作与触发条件 Leaderboard is successfully fetched 和 Failure to fetch leaderboard 结合使用。 操作和条件接受以下参数:
|
参数 |
类型 |
描述 |
|
Name |
|
排行榜的技术名称。 |
|
Top positions |
|
从排行榜顶部请求的条目数量。 |
|
Request player position |
|
决定是否请求用户的位置。 |
|
Positions around the player's position |
|
在表格中用户下方和上方请求的条目数量。 |
插件将通过 Yandex Games SDK 请求排行榜数据,请求成功后将开始循环。 此过程需要一些时间。
建议在过程进行期间在屏幕上保留加载指示器。
重要
请确保此循环不会被持续调用。 建议在函数或触发器中使用它。

在循环内部,您可以访问 Leaderboards 列表中的表达式。

