Google Play 游戏服务功能

通过 Google Play 游戏服务，您可为游戏添加极具吸引力的社交功能和多人游戏功能。

请在下方任选一个功能，了解其基本介绍以及实施 Google Play 游戏服务的相关说明文档。

使用入门

集成 Google Play 游戏服务 SDK

若要了解如何集成 Google Play 游戏服务 SDK，请访问 Google Developers 网站，以查看相关说明和使用入门示例。

创建游戏详情

若要使用 Google Play 游戏服务，您需在 Play 管理中心内创建游戏详情。您的游戏详情与应用的商品详情页面是分开显示的。

请按照下列方法添加新的游戏详情：

1. 打开 Google Play 管理中心。
2. 前往设置 > 游戏项目。
3. 点击右上角附近的添加新游戏。

功能

成就

借助成就，您可以让玩家在完成游戏中设置的目标时获得奖励，从而达到留住玩家的目的。玩家可以通过在游戏中达成成就来获得经验值 (XP)。

您可以访问 Google Developers 网站，详细了解成就。

注意：成就一旦发布，便无法删除。

添加成就

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

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

注意：使用 API 可为已登录玩家解锁成就。这会向玩家显示所有隐藏成就。

创建成就

如需为新游戏和未发布的游戏创建成就，请使用 Google Play 管理中心完成以下步骤：

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

创建成就后，您需要发布游戏。

添加更多成就

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

1. 在 Google Play 管理中心内，选择一款游戏。

2. 在 Play 游戏服务 - 成就页面（拓展 > Play 游戏服务 > 设置和管理 > 成就）上，选择添加成就。

导入成就

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

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

1. 1 上传该文件。

如需详细了解 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 消息框中显示成就图标时，该图标会与圆形叠加在一起，并且其外角会被盖住。请确保您的图标在此类情况下仍能正常显示。

成就图标示例。

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

ZIP 文件指南

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

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

ZIP 文件要求：

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

AchievementsMetadata.csv 格式

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

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

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

CSV 列标题	是必需还是可选	接受的值
Name	必需	最多 100 个字符
Description	可选	最多 500 个字符
Incremental Value	可选	True 或 False
Steps Needed	如果“Incremental Value”为 True，则为必需。	数字（不得包含分数或小数）
Initial State	必需	Hidden 或 Revealed
Points	必需	5 的倍数，值必须介于 5 到 200 之间
List Order	可选	数字（不得包含分数或小数，且大于零）

AchievementsMetadata.csv 文件要求：

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

AchievementsMetadata.csv 文件示例：

Achievement1,,True,100,Hidden,5,20

Achievement2,,False,,Revealed,10,30

AchievementsLocalizations.csv 格式

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

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

Name, Localized name, Localized description, locale

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

CSV 列标题	是必需还是可选	说明	接受的值
Name	必需	必须与 AchievementsMetadata.csv 中的“Name”列一致。	最多 100 个字符
Localized name	必需	成就的本地化名称。	最多 100 个字符
Localized description	可选	在指定语言区域中对成就的本地化说明。	最多 500 个字符
Locale	必需	语言区域代码，例如 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 列标题	是必需还是可选	说明
Name	必需	必须与 AchievementsMetadata.csv 中的“Name”列一致。
Icon filename	必需	图标文件的名称。

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

图标文件

您在 AchievementsIconMappings.csv 文件中引用的图标必须存在于您当前导入的 ZIP 归档文件中。如需了解详情，请参阅图标指南。

为成就添加翻译

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

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

• 您可以使用导入成就选项，一次为许多新成就上传翻译。您无法使用此选项为现有成就上传翻译。
• 您可为游戏中的每个成就添加翻译。如需为每项成就自行添加翻译，请执行以下操作：
  1. 在 Google Play 管理中心内，打开游戏的成就标签页，然后选择一项现有成就。
  2. 在成就详情页面中，选择与您之前在游戏详情标签页中添加的语言对应的标签页。
  3. 在该语言的成就详情页面中，修改包含该成就的相应翻译的表单。
  4. 点击保存即可存储翻译后的成就详情。

排行榜

借助排行榜，您可以让游戏玩家和好友比较得分并与顶级玩家展开激烈的竞争。

注意：排行榜上的得分无法重置，但您可以随时删除或隐藏排行榜。

若要隐藏现有排行榜上的可疑得分，您可以通过 Play 管理中心在相应游戏的排行榜页面上开启排行榜防篡改功能。

创建排行榜

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

1. 在 Google Play 管理中心内，选择一款游戏。
2. 前往拓展 > Play 游戏服务 > 设置和管理 > 排行榜，然后点击创建排行榜按钮。
3. 填写此排行榜所需的信息。
4. 点击保存为草稿，您的排行榜将处于“草稿”状态。
5. 当您发布游戏之后，所有游戏排行榜也会随之发布。

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

如需为已发布的游戏创建更多排行榜，请按照相同的步骤操作。如需详细了解如何测试游戏的更新版本，请参阅发布您的游戏更改。

对排行榜进行测试并获得满意结果后，您可以重新发布使用新排行榜的游戏，这些排行榜将推送到全球。

修改排行榜

如需修改已经创建的排行榜，请在 Google Play 管理中心内的排行榜标签页中点击相应的排行榜。此时，您会看到首次创建排行榜时使用的表单，并可酌情修改任何字段。

完成排行榜修改后，点击保存为草稿按钮。新修改的排行榜将处于“草稿”状态，以便您测试它。

如果一切正常运行，请从排行榜表单顶部的方框中选择发布更改，您就能够重新公开发布游戏以及所有更新后的排行榜。

撤消修改

如果您不喜欢新修改的排行榜，想还原到之前的版本，则只需从排行榜表单顶部的方框中选择还原即可。您的排行榜将还原为已发布的版本。

删除排行榜

您可以删除处于“草稿”状态的排行榜或已发布的排行榜。如需在 Google Play 管理中心内删除排行榜，请进入排行榜的表单，然后点击表单顶部的删除排行榜。

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

重置排行榜

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

• 如需在 Google Play 管理中心内重置排行榜，请点击相应活动表单顶部的重置进度。
• 如需以编程方式重置排行榜数据，请调用 Management API Scoresmethods。

为排行榜添加翻译

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

如需为排行榜自行添加翻译，请在 Google Play 管理中心内打开游戏的排行榜标签页，然后选择一个现有的排行榜。在排行榜详情页面中，点击与您之前在游戏详情标签页中添加的语言对应的标签页。在该语言的排行榜详情页面中，修改包含该排行榜的相应翻译的表单。点击保存即可存储翻译后的排行榜详情。

隐藏排行榜得分

Google Play 游戏服务提供排行榜防篡改功能，可用于检查疑似经过篡改的得分并自动将其隐藏。此功能仅适用于 Android 游戏。

您为 Android 游戏创建的新排行榜会默认启用防篡改功能，但对于现有排行榜，此功能处于停用状态。如需为已发布的排行榜启用防篡改功能，请按照以下步骤操作：

1. 在 Google Play 管理中心内，打开游戏服务标签页，然后从列表中选择您的游戏。
2. 打开排行榜标签页，然后选择要启用防篡改功能的排行榜实例。
3. 将启用排行榜防篡改功能选项设为开启。
4. 点击保存并继续。
5. 发布游戏。

在 Google Play 管理中心内为排行榜启用防篡改功能后，该功能最多可能需要 24 小时才会生效。对于在您启用防篡改功能之前提交的得分，系统不会以追溯方式将其隐藏。

在某些情况下，您可能希望停用防篡改功能（例如，您的游戏除了在 Android 平台上运行以外，还要在网络平台上运行，并跨这些平台共享排行榜）。

游戏存档

借助游戏存档，您可以让游戏玩家轻松地保存自己的游戏进度。玩家的游戏进度和元数据可以在使用 Google Play 游戏服务的多部设备之间进行同步。

您可以访问 Google Developers 网站，了解如何实施游戏存档。

启用游戏存档

如需启用游戏存档服务，请在 Play 管理中心内完成以下步骤：

1. 在 Google Play 管理中心内，选择一款游戏。
2. 在 Play 游戏服务 - 配置页面（拓展 > Play 游戏服务 > 设置和管理 > 配置）上，选择修改属性。
3. 将游戏存档选项设为开启。
4. 点击保存。

执行上述步骤后，Google Play 游戏服务最长可能需要 24 小时才能为您的游戏激活游戏存档服务。如果您想立即测试游戏存档服务，请在测试设备上手动清除 Google Play 服务应用中的数据。

如需清除 Android 上的缓存数据，请依次选择设置 > 应用 > Google Play 服务，点击管理空间，然后点击清除所有数据。

如需详细了解游戏存档服务，请参阅游戏存档游戏指南。

添加翻译

您可为游戏详情设置自己的翻译，包括显示名称、游戏说明和图形资源。您还可为与您游戏关联的成就和排行榜自行指定翻译。

如需为游戏详情自行添加翻译，请按照以下步骤操作：

1. 在 Google Play 管理中心内，选择一款游戏。
2. 前往 Play 游戏服务 - 配置页面（拓展 > Play 游戏服务 > 设置和管理 > 配置）。
3. 选择修改属性。
4. 依次选择管理翻译 > 管理您自行提供的翻译。
5. 选择您要提供的翻译语言，然后点击应用以确认您的选择。在属性页面中，您所选择的语言将包含在语言选择器中。
6. 从语言选择器中选择要修改的语言，然后在表单中修改显示名称、说明和图形资源的对应翻译。
7. 点击保存更改以存储翻译后的游戏详细信息。

如需详细了解如何为成就和排行榜添加翻译，请参阅成就和排行榜指南。

当显示游戏详细信息、排行榜和成就字符串时，Play 游戏服务会从游戏支持的语言中选择使用与用户请求的语言最接近的语言。例如，如果用户的设备语言偏好设置为法语（加拿大）(fr-CA)，但游戏仅支持英语（美国）(en-US) 和法语（法国）(fr-FR)，则 Play 游戏服务会选择显示 fr-FR 字符串，因为这是最接近的匹配语言。

向用户授予修改权限

若要在 Play 管理中心内修改 Play 游戏服务设置，您必须确保您的团队拥有管理 Play 游戏服务的权限。如需详细了解 Play 管理中心中的权限，请参阅添加开发者账号用户并管理权限。

Google Play Game Services Publishing API

若要让系统自动配置应用并将应用发布操作集成到现有的自动化工具和流程中，请使用 Google Play Games Services Publishing API。您可按照以下步骤，通过 Play 管理中心开启对 Google Play Game Services Publishing API 的访问权限。

1. 打开 Google Play 管理中心。
2. 前往设置图标 API 访问权限。
3. 如果您尚未创建关联的项目，请先创建一个。
4. 点击“Games configuration API”旁边的启用按钮。

管理多个用户

如果有多个用户通过您的开发者账号管理游戏，您需要在 Play 管理中心的“用户和权限”页面上管理权限。