集成成就

创建成就

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

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 文件中使用的确切文件名：

ZIP 文件要求：

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

AchievementsMetadata.csv 格式

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

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

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

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

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

AchievementsLocalizations.csv 文件要求：

• 游戏中的成就名称在每个语言区域中均必须保持唯一。

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

• 每行应包含 4 个值。如果您想省略“本地化说明”值，请将其留空。

一个 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

AchievementsIconsMappings.csv 格式

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

Name, icon filename

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

AchievementsIconsMappings.csv 文件要求：

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

一个 AchievementsIconsMappings.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]中显示时，会叠加圆形边框且隐藏外棱角。请确保图标在该显示效果下依然美观。

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

图标文件

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

修改成就

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

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

   这将重新发布您的游戏以及所有更新后的成就。

删除成就

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

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

重置成就

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

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