集成成就

本文档介绍了如何使用 Google Play 管理中心或 API 调用将成就集成到游戏中。本文介绍了成就的基本元素和状态，并说明了如何创建、导入和管理成就。

准备工作

创建或导入新成就

如需从头开始实现成就，请按以下步骤操作：

添加成就

首次使用 Google Play 管理中心创建成就的方式有两种：

  • 创建成就：一次为一个成就添加定义和元数据。
  • 导入成就：只需 1 步即可同时导入多个成就的定义和其他元数据。

创建成就

如需为新游戏和未发布的游戏创建成就，请完成以下步骤：

  1. 在 Google Play 管理中心内，选择一款游戏。
  2. 在 Play 游戏服务 - 成就页面（拓展 > Play 游戏服务 > 设置和管理 > 成就）上，选择创建成就。
  3. 在添加成就页面中，填写表单。
  4. 点击保存为草稿。
  5. 创建成就后，您需要发布成就。
导入成就

如需一次向游戏中添加多个成就，请按照以下步骤操作：

  1. 创建一个包含您的成就的 ZIP 文件。
  2. 上传文件。

如需详细了解 ZIP 文件，请参阅 ZIP 文件指南。

如需导入成就，请执行以下操作：

  1. 在 Google Play 管理中心内，选择一款游戏。
  2. 在 Play 游戏服务 - 成就页面（拓展 > Play 游戏服务 > 设置和管理 > 成就）上，选择导入成就。
  3. 在导入成就页面中，点击上传。
  4. 选择要上传的 ZIP 文件。
  5. 点击保存为草稿。
  6. 导入成就后，您需要发布游戏。

ZIP 文件指南

您可以使用 ZIP 文件一次导入多个成就。请参阅下表，了解要在 ZIP 文件中使用的确切文件名：

文件名 是必需还是可选 接受的值
AchievementsMetadata.csv 必需 每项成就的元数据。 请参阅属性。
AchievementsLocalizations.csv 可选 提供成就名称和说明的翻译。
AchievementsIconMappings.csv 可选 将成就映射到其图标文件。
图标文件 可选 采用 PNG、JPEG 或 JPG 格式的图标。

ZIP 文件要求：

  • 不含子目录。
  • 独一无二的文件名。
  • 仅限 CSV、PNG、JPEG 或 JPG 格式的文件。
  • CSV 文件不得包含标题行。
  • 每个文件的大小不得超过 1 MB。
  • ZIP 文件所含文件数量不得超过 203 个。
  • ZIP 文件总大小不得超过 200 MB。
AchievementsMetadata.csv 格式

AchievementsMetadata.csv 文件包含每个成就的元数据。该文件应以逗号分隔值形式按以下顺序包含相应信息：

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

下表对这些字段进行了说明。

CSV 列标题 是必需还是可选 接受的值
名称 必需 最多 100 个字符
说明 可选 最多 500 个字符
增量值 可选 True 或 False
所需步数 如果 Incremental Value 为 True.，则必须提供此值 数字（不得包含分数或小数）
初始状态 必需 Hidden 或 Revealed
积分 必需 5 的倍数，值必须介于 5 到 200 之间
列表顺序 可选 数字（不得包含分数或小数，且大于零）

AchievementsMetadata.csv 文件要求：

  • 每行都必须包含 7 个值。如果您想省略某个值，请将其留空。
  • Name 和 Description 字段将用作默认语言区域。
  • Name 字段在所有成就中都应独一无二。
  • 以下字段不应包含英文逗号：Name 和 Description。

AchievementsMetadata.csv 文件示例：

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30
AchievementsLocalizations.csv 格式

AchievementsLocalizations.csv 文件是一个可选文件，用于设置向不同语言区域的用户描述每项成就时所需的所有数据。成就会根据为游戏指定的语言区域进行翻译。

该文件应以逗号分隔值形式按以下顺序包含相应信息： 

   Name, Localized name, Localized description, locale

下表对这些字段进行了说明：

CSV 列标题 是必需还是可选 说明 接受的值
名称 必需 必须与 AchievementsMetadata.csv 中的 Name 列匹配。 最多 100 个字符
本地化名称 必需 成就的本地化名称。 最多 100 个字符
本地化说明 可选 在指定语言区域中对成就的本地化说明。 最多 500 个字符
语言区域 必需 语言区域代码，例如 en-US。 请先为游戏 添加翻译，然后再指定语言区域。请注意，您无法指定默认语言区域。

如需查看受支持的语言区域代码，请参阅 支持的语言列表。

AchievementsLocalizations.csv 文件要求：

  • 游戏中的成就名称在每个语言区域中均必须独一无二。

    例如，如果游戏同时支持 en-US 和 fr-FR 语言区域，则在 en-US 语言区域中名为“Achievement1”的成就在 fr-FR 语言区域中也可以名为“Achievement1”。

  • 每行应包含 4 个值。如果您想省略“Localized description”值，请将其留空。

AchievementsLocalizations.csv 文件示例：

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE
AchievementsIconMappings.csv 格式

AchievementsIconMappings.csv 文件是一个可选文件，用于将您的成就与给定图标相映射。该文件应以逗号分隔值形式按以下顺序包含相应信息： 

Name, icon filename

下表对这些字段进行了说明

CSV 列标题 是必需还是可选 说明
名称 必需 必须与 AchievementsMetadata.csv 中的 Name 列匹配。
图标文件名 必需 图标文件的名称。

AchievementsIconMappings.csv 文件要求：

  • 每行应包含 2 个值。
  • 图标文件只能采用 PNG 或 JPEG 格式。

AchievementsIconMappings.csv 文件示例：

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

图标指南

图标应创建为 512 x 512 的 PNG、JPEG 或 JPG 文件。您只需向我们提供已达成的成就的图标。我们将自动为显示的图标生成灰度版本。因此，我们建议您在成就图标中包含彩色元素，以便用户区分显示的成就和达成的成就。

在 Android [消息框][a]中显示成就图标时，该图标会与圆圈叠加在一起，并且其外角会被盖住。请确保您的图标在此类情况下仍能正常显示。

成就图标示例。
成就图标示例。

所有语言区域均使用相同的图标，因此我们建议您不要在图标中添加任何文本或本地化内容。

图标文件

您在 AchievementsIconMappings.csv 文件中引用的图标必须存在于您当前导入的 ZIP 归档文件中。

更新了包含现有成就的游戏

您可以在 Google Play 管理中心内为游戏添加更多成就，并更新现有成就。

添加更多成就

如果您已有一些成就，并且想添加更多成就，请执行以下操作：

  1. 在 Google Play 管理中心内，选择一款游戏。
  2. 在 Play 游戏服务 - 成就页面（拓展 > Play 游戏服务 > 设置和管理 > 成就）上，选择添加成就。
修改成就

如果您已有一些成就，并且想进行修改，请执行以下操作：

  1. 在 Google Play 管理中心内，选择一款游戏。
  2. 在 Play 游戏服务 - 成就页面（拓展 > Play 游戏服务 > 设置和管理 > 成就）上，选择一项成就。
  3. 您可以修改任何字段。
  4. 点击保存为草稿。
  5. 在 Play 游戏服务 - 成就页面中，修改后的成就处于“可供测试人员使用”状态。
  6. 测试成就后，点击检查并发布。

    这会重新向公众发布您的游戏以及所有更新后的成就。
删除成就

成就一旦发布，便无法删除。 您只能删除处于预发布状态的成就

  1. 在 Play 游戏服务 - 成就页面中，选择一项成就。
  2. 如需删除成就，请点击删除成就。
重置成就

您只能重置草稿成就的玩家进度数据。

  1. 在 Play 游戏服务 - 成就页面中，选择一项成就。
  2. 如需重置成就，请点击重置进度。
  3. 如需以程序化方式重置成就数据，请调用 Management API Achievements 方法。

为成就添加翻译

您可以自行为与游戏相关联的成就指定翻译。在此之前，请确保先完成为游戏添加翻译中所述的步骤。

您可通过以下两种方式为游戏添加翻译：

  • 您可以使用导入成就选项，一次为许多新成就上传翻译。您无法使用此选项为现有成就上传翻译。

  • 您可以为游戏中的每个成就添加翻译。 如需为每项成就自行添加翻译，请执行以下操作：

    1. 在 Google Play 管理中心内，打开游戏的成就标签页，然后选择一项现有成就。
    2. 在成就详情页面中，选择与您之前在游戏详情标签页中添加的语言相对应的标签页。
    3. 在该语言的成就详情页面中，修改包含该成就的相应翻译的表单。
    4. 点击保存即可存储翻译后的成就详情。

客户端实现

如需了解如何为您的平台实现成就功能，请参阅以下资源：

测试成就

如需验证成就是否按预期运行，请按以下步骤进行测试：

  • 设置内部测试轨道。
  • 为测试人员向游戏项目添加测试账号。
  • 使用 Play Games 应用为其中一个测试账号创建 Play Games 服务玩家资料。
  • 使用您创建 Play Games 服务玩家资料时所用的同一测试账号打开游戏。
  • 验证在游戏启动时，屏幕上是否会显示 Play 游戏服务“欢迎消息框”，以确认自动身份验证成功。
  • 玩游戏并完成所需步骤，即可解锁成就。

  • 如需验证成就，请执行以下操作：

    • 验证在完成成就时，屏幕上是否会显示“成就已解锁”弹出式窗口。

    • 打开 Play 商店应用，然后验证“我”标签页上的“成就”部分是否显示已完成的成就以及正在进行的成就（附带进度详细信息）。

在 Play 管理中心内跟踪成就表现

以下是查找各个成就概要统计信息的方法：

  • 在 Google Play 管理中心内。
  • 依次前往设置> 游戏项目。
  • 选择游戏。
  • 在左侧菜单中，点击成就。
  • 在成就页面中，您可以查看统计信息，了解玩家是否在解锁成就。对于未隐藏成就的用户，您可以查看解锁成就的用户所占的百分比。对于早期阶段的成就，解锁百分比通常接近 100%。

您还可以在拓展 > Play 游戏服务 > 游戏统计信息页面中跟踪成就的时间序列表现。

发布成就

完成测试后，您必须发布游戏。 所有游戏成就也会随之发布。发布成就对于成就功能的正常运行至关重要。

如需发布，请按以下步骤操作：

  1. 在 Google Play 管理中心内，选择一款游戏。
  2. 在 Play 游戏服务 - 成就页面（拓展 > Play 游戏服务 > 设置和管理 > 成就）上，点击检查并发布。
  3. 在 Play 游戏服务 - 发布页面（拓展 > Play 游戏服务 > 设置和管理 > 发布）中，查看操作并修正问题。
  4. 点击发布。

    所有游戏成就均已发布。

常见错误避雷

以下几点突出了在游戏中实现成就时应避免的常见错误。他们强调以下方面的重要性：

  • 在 Play 管理中心内，依次前往拓展 > Play 游戏服务 > 设置和管理 > 成就。

    • 发布之前，请验证在 Play 管理中心内配置的成就是否未处于“草稿”状态。
    • 请勿将 Play 管理中心内的成就 ID 值添加到游戏代码中。请改用客户端实现。

  • 确保您还在客户端上实现了解锁逻辑。

    • 玩家无法跳过调用解锁 API 的触发步骤。 例如，完成教程是一项成就，但玩家可以跳过教程本身。