排行榜

排行榜可以成为在玩家之间激发竞争的有趣方式，无论对于您最铁杆的粉丝（他们将争夺公开排行榜的榜首位置）还是对于您更休闲的玩家（他们将对将自己的进度与朋友进行比较感兴趣）。

要了解如何为您的平台实现排行榜，请参阅客户端实现。

了解排行榜

当您创建排行榜时，Play 游戏服务将负责为您管理此排行榜的大多数方面。典型流程如下

  1. 在游戏结束时（或您确定的适当时刻），游戏会将玩家的分数提交到您为游戏创建的一个或多个排行榜。
  2. Play 游戏服务检查此分数是否优于玩家当前的每日、每周或总分排行榜条目。如果是，Play 游戏服务会使用新分数更新相应的排行榜。
  3. Play 游戏服务将分数报告发送回游戏客户端。此报告告诉客户端这是否是新的每日、每周或历史最高分。如果不是，Play 游戏服务将告诉客户端此玩家的当前每日、每周或历史最高分是多少。
  4. 要检索玩家的排行榜结果，您可以请求一个时间范围（每日、每周或总分），并指定用户是否希望查看社交或公开排行榜。Play 游戏服务执行所有必要的过滤，然后将结果发送回客户端。
  5. 在需要报告大量分数的情况下，Play 游戏服务只会发送回排行榜最高分数的数据。您还可以检索最高分数或玩家相邻分数的原始分数数据。

多个排行榜

游戏可以有多个排行榜，最多 70 个。例如，多级游戏可能为每个级别提供不同的排行榜，赛车游戏可能为每个赛道提供单独的排行榜。

排行榜时间范围

Play 游戏 SDK 会自动创建您创建的每个排行榜的每日、每周和总分版本。您无需为每个时间范围创建单独的排行榜。

每日排行榜在 UTC-7（即“太平洋夏令时午夜”）全年重置。

每周排行榜在星期六和星期日之间的午夜重置，与每日排行榜位于同一时区（UTC-7）。

公开排行榜和社交排行榜

Play 游戏 SDK 可以向玩家显示每个排行榜的两个不同版本

**社交**排行榜是由用户圈子中的人员（或更准确地说，是用户选择与您的应用程序共享的圈子的成员）组成的排行榜，他们已决定将他们的游戏活动分享给用户。

**公开**排行榜是由选择公开分享其游戏活动的玩家组成的排行榜。如果您的玩家没有选择公开分享他们的游戏活动，他们将不会出现在此排行榜中。

显示排行榜

在移动客户端库中，库负责所有排行榜的格式化和显示。您可以指定玩家是否可以查看特定排行榜，或者查看他们可以从中选择的全部排行榜列表。

您还可以通过直接从客户端库访问数据来实现您自己的排行榜版本。

属性

要创建和管理排行榜，您需要熟悉以下排行榜属性

基础知识

这些基本元素与每个排行榜相关联

  • **ID** 是 Google Play Console 将为您生成的唯一字符串。您将使用此唯一 ID 在游戏客户端中引用排行榜。
  • **名称** 是排行榜的简短名称（例如，“高分”或“第 3 关”）。最多可包含 100 个字符。
  • **图标** 是与排行榜关联的方形图标。有关创建排行榜图标的最佳实践，请参阅图标指南。
  • **列表顺序** 是玩家查看与游戏关联的排行榜时排行榜出现的顺序。
  • **限制** 是定义排行榜中允许的分数的下限和上限的可选值。这可以帮助您丢弃明显存在欺诈性的分数提交。您还可以使用Players.hide隐藏您认为已从应用中所有排行榜提交了欺诈性分数的玩家。

排序排行榜

排行榜可以具有两种排序类型之一

  • **越大越好** 排行榜是默认设置。这通常是您在大多数游戏中看到的，玩家在游戏中获得积分。

  • 较小值更好排行榜偶尔用于较小的分数更佳的情况。此类排行榜最常见的示例是赛车游戏，其中分数代表玩家完成比赛的时间。

分数格式

虽然所有分数都提交到排行榜并在内部存储为长整数，但 Play 游戏服务可以以多种不同的格式将其呈现给用户。

  • 数字排行榜将分数显示为数字。这些可以显示为整数或带有一定数量小数位的实数。您提交分数为整数，并在指定位置插入小数点。例如，分数 314159 将显示为 3.14159、3141.59 或 314159，具体取决于您指定的小数位数。

  • 时间排行榜以小时/分钟/秒/百分之一秒的格式显示分数。您必须以毫秒为单位提交分数，因此 66032 将解释为 1:06.03。

  • 货币排行榜以货币格式显示分数。您提交的分数为主要货币单位的百万分之一。例如，分数 19,950,000 将解释为 $19.95，假设您将货币指定为 USD。

数字排行榜还支持自定义单位。例如，如果您的游戏以米为单位测量高分，您可以将“米”指定为排行榜的默认单位。

翻译和分数格式

当移动客户端库从 Play 游戏服务请求排行榜数据时，它们会指定显示这些分数的语言和区域设置。该 REST API 允许您指定基于区域设置的语言。Play 游戏服务返回适合该语言和区域设置的格式化排行榜分数。无论您是否为排行榜添加了 翻译，这些格式化的分数都将显示。

对于数字排行榜，数字格式在每种语言中的显示方式不同。（例如，在美国为 12,345.78，在法国为 12 345,78。）如果您使用自定义单位并已为您的游戏添加了 翻译，则必须为添加的每种语言提供翻译后的单位。然后，服务会在适当的地方显示这些翻译后的单位。

根据您选择的语言，您可能需要提供不同版本的单位名称。在英语中，您需要一个项目版本，另一个版本用于所有其他项目（例如，“meter”和“meters”）。另一方面，在波兰语中，您需要提供一个单位版本、几个单位版本、许多单位版本以及所有其他单位版本。要了解有关复数规则的更多信息，请参阅 数量字符串（复数）。

对于时间排行榜，时间格式将根据玩家的语言和区域设置显示。如果您使用秒的分数或小时值超过 3 位数（例如，在美国为 4,815:16:23.42，在德国为 4.815:16:23,42），这将主要显而易见。

对于货币排行榜，货币格式将根据玩家的语言和区域设置显示。但是，您无法更改货币单位。例如，如果您将货币指定为 USD，则游戏将在美国显示 $19.95，在法国显示 19,95 $。但是，您不能指定游戏在美国显示美元，在法国显示欧元。

图标指南

图标应创建为 512 x 512 PNG 或 JPEG 文件。您的图标将在大多数游戏客户端中缩小，因此您应避免创建包含过多精细细节的图标。您可以提交带有 alpha 通道的图标，并且会保留透明度。排行榜图标将在 Android 设备上的较暗灰色背景上显示，因此请选择在这种情况下效果良好的图标。

所有语言环境都使用相同的图标，因此我们建议不要在图标中包含任何文本或本地化内容。

创建排行榜

本节介绍如何为新游戏或现有游戏创建排行榜。

为新游戏创建排行榜

要为新游戏和未发布的游戏创建排行榜，请转到游戏的 Google Play Console 条目，然后导航到发展 > Play 游戏服务 > 设置和管理 > 排行榜，然后点击创建排行榜按钮。

The 'Add Leaderboard' button on the main Leaderboards Panel
主要排行榜面板上的“添加排行榜”按钮

然后，只需填写此排行榜所需的信息即可。

A filled-out form for the 'Best round' leaderboard.
“最佳回合”排行榜的已填写表格。

点击保存为草稿，您的排行榜将处于“草稿”状态。发布游戏后，游戏的所有排行榜都将随之发布。

为已发布的游戏创建排行榜

要为已发布的游戏创建其他排行榜，请按照上述步骤操作。有关测试游戏更新版本的更多信息，请参阅 发布游戏更改。

测试排行榜并满意后，您可以重新发布包含新排行榜的游戏，并将它们推送到全世界。

编辑排行榜

要编辑您已创建的排行榜，请点击 Google Play Console 的排行榜选项卡中的排行榜。此时，您将看到与首次创建排行榜时使用的相同表单，并且可以根据需要编辑任何字段。

编辑完排行榜后，点击保存为草稿按钮。新编辑的排行榜将处于“草稿”状态，这使您可以对其进行测试。

如果运行正常，请从排行榜表单顶部的框中选择发布更改，然后您就可以重新发布您的游戏以及所有更新的排行榜供公众使用。

撤消编辑

如果您决定不喜欢新编辑的排行榜并希望返回到以前的版本，只需从排行榜表单顶部的框中选择还原。您的排行榜将恢复到已发布的版本。

删除排行榜

您可以删除处于“草稿”状态或已发布的排行榜。要在 Google Play Console 中删除排行榜，请转到排行榜的表单，然后点击表单顶部的删除排行榜。

或者，您可以调用 Players.hide 以隐藏应用中玩家的排行榜。

重置排行榜

您只能重置草稿排行榜的玩家进度数据。

  • 要重置 Google Play Console 中的排行榜，请点击该事件表单顶部的重置进度。
  • 要以编程方式重置排行榜数据，请调用 管理 API Scores方法。

添加排行榜翻译

您可以为与您的游戏关联的排行榜指定自己的翻译。在执行此操作之前，请确保首先完成 为您的游戏添加翻译中描述的步骤。您还必须为您的游戏创建了一个或多个排行榜。

要添加您自己的排行榜翻译，请在 Google Play Console 中打开游戏的排行榜选项卡，然后选择一个现有的排行榜。在排行榜详细信息页面上，点击您之前在游戏详细信息选项卡中添加的语言的选项卡。在该语言的排行榜详细信息页面中，使用您的翻译编辑该排行榜的表单。点击保存以存储您翻译的排行榜详细信息。

隐藏排行榜分数

Google Play 游戏服务提供了一个排行榜篡改保护功能，该功能会检查可疑的篡改分数并自动将其隐藏。此功能仅适用于 Android 游戏。

对于您为 Android 游戏创建的新排行榜，默认情况下会启用篡改保护，但对于现有排行榜则已禁用。要为已发布的现有排行榜启用篡改保护，请按照以下步骤操作

  1. 在 Google Play Console 中，打开游戏服务选项卡，然后从列表中选择您的游戏。
  2. 打开排行榜选项卡，然后选择要为其启用篡改保护的排行榜实例。
  3. 将启用排行榜篡改保护选项切换为“开”。
  4. 点击保存并继续。
  5. 发布您的游戏。

在 Google Play Console 中为排行榜启用篡改保护后，此功能可能需要长达 24 小时才能生效。在您启用篡改保护之前提交的分数不会被追溯隐藏。

在某些情况下，您可能希望禁用篡改保护（例如，如果您的游戏除了在 Android 上运行外还在网络上运行，并且在这些平台之间共享排行榜）。

客户端实现

要了解如何为您的平台实现排行榜，请参阅以下资源