排行榜

视频教程。如何在我的游戏中添加排行榜？ 观看视频

排行榜是一种工具，可用于在游戏页面上向玩家显示个性化竞赛表，其中包含顶级玩家的成绩以及已登录用户在排名中的位置。

可以通过两种方式添加排行榜：

• 使用 Yandex Games SDK 启用。SDK 排行榜仅考虑已登录用户的成绩。
• 在游戏代码中自行编写，以便竞赛表考虑所有用户的成绩，无论是否登录。对于用户期望立即看到自己的记录或获得的分数的游戏，实现此类排行榜非常重要。

创建排行榜

要启用排行榜，需要将 SDK 代码添加到游戏的源文件中，并通过控制台启用排行榜。

1. 添加 SDK 代码到游戏的源文件中。

2. 转到开发人员控制台。

3. 选择所需的游戏。

4. 转到 Leaderboards 选项卡。

5. 填写字段：

   字段	描述
   Technical leaderboard name	用于 SDK 中交互的名称。
   Localized leaderboard name for display	向用户显示的名称： 对于主要语言，在 [<语言代码>] Displayed leaderboard name字段中指定名称。 对于其他语言，点击Add localization to <语言代码>，在出现的字段中指定所选语言的名称。 可能的语言代码列于页面 语言与域名。
   Main leaderboard	Is main leaderboard? 选项确定将在游戏卡上显示哪个排行榜。 重要 主排行榜只能有一个。如果您创建一个新的排行榜并将其设为主排行榜，该选项将在之前的排行榜中自动禁用。
   Leaderboard type	排行榜类型，决定成绩的计量单位。可能的值： numeric — 数字。 time — 以毫秒为单位的时间。 允许值的范围 参数 score 的类型为 number，不能为负数，其最大值受 JavaScript 逻辑限制。如果您想在排行榜中显示小数，请设置 Size of the decimal part of the score。 对于 time 类型的排行榜，值也被视为整数并以毫秒传递（1秒 = 1000毫秒）。 有关详细信息，请参阅 Mozilla 文档。
   Sort order	排行榜中成绩的排列顺序。可能的值： Descending sort — 得分最高的用户排在最前面。 Ascending sort — 得分最低的用户排在最前面。 例如，对于快速通关比赛，需要选择 Ascending sort 方向和 time 排行榜类型。
   Size of the decimal part of the score	该参数决定分数整数中有多少位数字将在小数点后显示。例如，如果设置大小为 2，分数值 5712 将显示为 57.12。

6. 点击 Submit。

之后，将创建一个以卡片形式显示玩家 ID 的排行榜。您可以为不同的用户组启用多个排行榜。

可以使用旧名称创建新排行榜吗？

无法重复使用已删除排行榜的名称。也无法创建两个同名的排行榜。尝试输入与旧名称不同的名称。

编辑排行榜

要查看或编辑已添加的排行榜，在 Leaderboards 选项卡上向下滚动页面并点击 Edit leaderboard '<Technical leaderboard name>'。在那里您可以更改：

• 技术名称。
• 本地化显示名称。
• 排行榜是否为主排行榜。

有关填写字段的详细信息，请参阅 创建排行榜 部分。