成就

成就可能是在游戏中提高用户参与度的好方法。您可以在游戏中实施成就,鼓励玩家尝试他们通常不会使用的功能,或者以完全不同的游戏风格玩游戏。成就也可以是玩家相互比较进度并进行轻松竞争的有趣方式。

要了解如何为您的平台实施成就,请参阅客户端实现

属性

要了解成就的工作原理,您需要熟悉与成就相关的一些属性。

这些基本元素与每个成就相关联:

  • ID 是由 Google Play 管理中心生成的唯一字符串。您将使用此唯一 ID 在游戏客户端中引用成就。
  • 名称是成就的简称(例如,“派人”)。该值最多可包含 100 个字符。
  • 说明是对成就的简洁描述。通常,这会告诉玩家如何获得成就(例如,“在日落前烤一个柠檬蛋白派”)。该值最多可包含 500 个字符。
  • 图标是与您的成就相关联的方形图标。有关创建成就图标的最佳实践,请参阅图标指南部分。
  • 列表顺序是玩家查看与您的游戏相关联的成就时,锁定成就出现的顺序。这可以是您喜欢的任何顺序。解锁的成就按获得顺序显示在列表顶部。

状态

成就可处于三种不同状态之一:

  • 隐藏成就表示成就的详细信息对玩家隐藏。Play 游戏服务为处于隐藏状态的成就提供通用占位符描述和图标。如果成就包含您不希望过早透露的游戏剧透(例如,“发现你一直都是鬼魂!”),我们建议将其设为隐藏。
  • 已显示成就表示玩家知道成就,但尚未获得。大多数成就都从“已显示”状态开始。
  • 已解锁成就表示玩家已成功获得成就。成就可以在离线状态下解锁。当游戏在线时,它会与 Play 游戏服务同步以更新成就的解锁状态。

增量成就

成就可指定为标准或增量。通常,增量成就涉及玩家在较长时间内逐步取得进展以获得成就。随着玩家在增量成就方面取得进展,您可以将玩家的部分进展报告给 Play 游戏服务。

Google Play 服务会跟踪进度信息,在玩家满足解锁成就的条件时提醒游戏,并告诉玩家他们距离实现该目标还有多远。

A sample incremental achievement showing the player's progress at 23%.
增量成就显示玩家进度为 23%。

增量成就会在游戏会话中累积,且进度无法从游戏中删除或重置。例如,“赢得 50 场游戏”将符合增量成就的条件。“连续赢得 3 场游戏”则不符合,因为玩家输掉游戏时进度会重置。“拥有 5,000 个扑克筹码”也不符合,因为玩家在游戏过程中可能会获得和失去筹码。对于后两个成就,由您来跟踪玩家的“连胜”状态或筹码总数,并在玩家获得成就时解锁标准成就。

创建增量成就时,您必须定义解锁它所需的总步数(此数字必须介于 2 到 10,000 之间)。随着用户在解锁成就方面取得进展,您应向 Play 游戏服务报告用户已完成的额外步数。一旦总步数达到解锁值,成就就会解锁(即使它被隐藏)。您无需存储用户的累积进度。

积分

成就具有相关的积分值。玩家的得分必须是 5 的倍数,并且游戏的所有成就总分不能超过 1000 分(尽管可以更少)。此外,单个成就不能超过 200 分。

跟踪经验值 (XP)

玩家在支持 Play 游戏的应用程序中获得成就时,其游戏个人资料中的等级可以提升。对于与成就关联的每个积分,玩家在获得该成就时可获得 100 经验值 (XP)。换句话说:

成就的 XP = 100 *(成就的积分值)

Play 游戏服务会跟踪每个玩家获得的经验值,并在玩家获得足够积分“升级”时向 Google Play 游戏应用发送通知。玩家可以在 Google Play 游戏应用中从其个人资料页面查看其等级和经验值历史记录。

最低成就数量

集成成就的游戏在发布前应至少有五个成就。您可以使用少于五个成就进行测试,但建议您在发布游戏前至少创建五个成就。

最高成就数量

成就数量受积分限制和分布的限制。在最高积分 1000 分且每个成就分配 5 分的情况下,最大成就数量为 200 个。但是,如果成就分配的积分更多,则可用成就数量会相应减少。

添加成就

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

  • 创建成就:一次添加一个成就的定义和元数据。
  • 导入成就:一次性导入多个成就的定义和其他元数据。

创建成就

要为新的未发布游戏创建成就,请完成以下步骤:

  1. Google Play 管理中心中,选择一个游戏。
  2. Play 游戏服务 - 成就页面(发展 > Play 游戏服务 > 设置和管理 > 成就)中,选择创建成就
  3. 添加成就页面中,填写表单。
  4. 点击保存为草稿
  5. 创建成就后,您需要发布您的游戏

添加更多成就

如果您已有成就并想添加更多:

  1. Google Play 管理中心中,选择一个游戏。
  2. Play 游戏服务 - 成就页面(发展 > Play 游戏服务 > 设置和管理 > 成就)中,选择添加成就

导入成就

要一次向您的游戏添加多个成就,请使用以下步骤:

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

有关 zip 文件的更多信息,请参阅Zip 文件指南

要导入成就:

  1. Google Play 管理中心中,选择一个游戏。
  2. Play 游戏服务 - 成就页面(发展 > Play 游戏服务 > 设置和管理 > 成就)中,选择导入成就
  3. 导入成就页面中,点击上传
  4. 选择要上传的 zip 文件。
  5. 点击保存为草稿
  6. 导入成就后,您需要发布您的游戏

发布您的游戏

一旦您测试并发布您的游戏,您的游戏的所有成就都会随之发布。

编辑成就

要编辑您已创建的成就,请在 Google Play 管理中心的“成就”标签页中选择该成就。此时,您将看到首次创建成就时使用的同一表单,并且您可以根据需要编辑任何字段。

编辑成就完成后,点击“保存为草稿”按钮。新编辑的成就将处于“准备测试”阶段,您可以对其进行测试。如果运行正常,请从下拉列表中选择“重新发布”。这将重新发布您的游戏以及所有更新的成就,供公众使用。

撤消编辑

如果您决定不喜欢当前的成就,并想恢复到之前的成就版本,请在 Google Play 管理中心的下拉列表中选择“恢复”,您所有的成就都将恢复到之前发布的版本。

删除成就

您的成就一旦发布,就无法删除。

您只能通过点击该成就表单底部的删除按钮来删除处于预发布状态的成就。

重置成就

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

  • 要在 Google Play 管理中心重置成就,请点击该事件表单底部的“重置成就进度”按钮。
  • 要以编程方式重置成就数据,请调用 Management API Achievements 方法

图标指南

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

当成就图标显示在 Android 浮动通知中时,图标会被圆形覆盖,其外角将被隐藏。请确保您的图标在这种情况下仍然美观。

A sample achievement icon.
一个示例成就图标。

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

Zip 文件指南

您可以使用 zip 文件一次导入多个成就。请参阅下表以了解您在 zip 文件中使用的精确文件名:

文件名 必填或可选 接受的值
AchievementsMetadata.csv 必填 每个成就的元数据。请参阅属性
AchievementsLocalizations.csv 可选 提供成就名称和描述的翻译。
AchievementsIconMappings.csv 可选 将成就映射到其图标文件。
图标文件 可选 PNG、JPEG 或 JPG 格式的图标。

Zip 文件要求

  • 无子目录。
  • 唯一的文件名。
  • 仅 CSV、PNG、JPEG 或 JPG 文件。
  • CSV 文件不得有标题行。
  • 每个文件必须小于 1 MB。
  • zip 文件不应包含超过 203 个文件。
  • zip 文件总大小必须小于 200MB。

AchievementsMetadata.csv 格式

AchievementsMetadata.csv 文件包含每个成就的元数据。它应按以下顺序包含逗号分隔的信息:

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

这些字段在下表中描述:

CSV 列标题 必填或可选 接受的值
名称 必填 最多 100 个字符
描述 可选 最多 500 个字符
增量值 可选 TrueFalse
所需步数 如果 Incremental ValueTrue,则为必填项。 数字(无小数或分数)
初始状态 必填 HiddenRevealed
积分 必填 5 的倍数,且值介于 5 和 200 之间
列表顺序 可选 数字(无小数或分数,且大于零)

AchievementsMetadata.csv 文件要求

  • 每行必须有七个值。如果您想省略某个值,请将其留空。
  • NameDescription 字段用作默认语言区域。
  • Name 字段在所有成就中必须是唯一的。
  • 以下字段不应包含逗号:NameDescription

一个 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 语言区域,那么名为“Achievement1”的 en-US 成就也可以在 fr-FR 中命名为“Achievement1”。
  • 每行应有四个值。如果您想省略“本地化描述”值,请将其留空。

一个 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 文件要求

  • 每行应有两个值。
  • 图标文件只能是 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

图标文件

您在 AchievementsIconMappings.csv 文件中引用的图标必须存在于您导入的当前 zip 存档中。有关更多信息,请参阅图标指南

添加成就翻译

您可以为与您的游戏关联的成就指定自己的翻译。在此之前,请务必先完成为您的游戏添加翻译中描述的步骤。

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

  • 您可以使用导入成就选项一次上传多个新成就的翻译。您不能使用此选项上传现有成就的翻译。

  • 您可以为游戏中的每个成就添加翻译。要为每个成就添加您自己的翻译:

    1. 在 Google Play 管理中心中,打开游戏的“成就”标签页,然后选择一个现有成就。
    2. 在成就详情页面中,选择您之前在“游戏详情”标签页中添加的语言的标签页。
    3. 在该语言的成就详情页面中,使用您的翻译编辑该成就的表单。
    4. 点击保存以存储您的翻译成就详情。

客户端实现

要了解如何为您的平台实现成就,请参阅以下资源: