排行榜

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

为了使下面描述的请求正常工作，请确保您已在开发人员控制台中创建了排行榜。

提交分数

备注

此请求仅适用于已授权用户。建议提前进行授权，并且仅在用户提供个人数据时才使用排行榜。

使用 Set leaderboard score 动作将新分数提交到排行榜，参数如下：

例如，向排行榜提交分数可能如下所示：

备注

请求最多每秒发送一次，否则将被拒绝并返回错误。

建议将分数提交与延迟事件结合使用。

要开始使用排行榜，请使用 Fetch leaderboard 动作，配合触发条件 Leaderboard is successfully fetched 和 Failure to fetch leaderboard。这些动作和条件接受以下参数：

参数	类型	描述
Name	`string`	排行榜的技术名称。
Top positions	`number`	从排行榜顶部请求的记录数量。
Request player position	`boolean`	确定是否请求用户的位置。
Positions around the player's position	`number`	请求用户在表中上下的记录数量。

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

建议在进行此过程时在屏幕上保留某种加载指示。

重要

确保不要持续调用此循环。建议在函数或触发器内使用它。

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