共计 2919 个字符，预计需要花费 8 分钟才能阅读完成。
谷歌播放（Google Play）插件代码注释
简介
Google Play 插件允许您将游戏与 Google Play 游戏服务集成。用户可以登录、提交和查看分数，以及解锁成就。
设置 Google Play 游戏服务
要使用 Google Play 游戏服务，需要在 Google Play 开发者服务中注册账户。对于每款游戏，需要添加游戏信息、成就和排行榜等。
作为 Web 应用发布
链接 Web 应用后，将提供客户端 ID。将其复制到 Google Play 插件的客户端 ID 属性中。
作为 Android 应用发布
链接 Android 应用后，将提供客户端 ID 和应用程序 ID。对于 Android 应用，只需应用程序 ID。
在预览模式下启用访问
在 API 控制台中，添加预览 URL 到授权的 Javascript 源中。
添加测试用户
对于未发布的 Android 应用，只能使用注册的测试用户登录。
基本用法
等待 Google Play 插件加载完成后，自动尝试让用户登录。登录成功后，可以使用其他插件功能。
异步操作
Google Play 插件中的大多数操作都是异步的，不会立即完成。例如，“请求播放器详细信息”操作将在触发器运行后完成。
非即时请求和缓存（仅限 Android）
根据官方建议，使用非即时方法更新用户在服务器上的成就 / 排行榜信息。
Google Play 媒体资源
包括应用程序 ID、客户端 ID 和游戏 ID 等。
Google Play 条件
包括比较成就状态、在成就榜上成功 / 失败等。
Google Play 插件使用指南
Google Play Game Services 设置
要使用 Google Play Game Services，你需要注册一个 Google Play 开发者服务的账户。可能需要一次性的注册费。
添加游戏
对于每个你想使用 Google Play Game Services 的游戏，点击开发者控制台的游戏服务图标，然后点击“添加新游戏”。输入你的游戏名称，选择其类别，然后点击“继续”。
编辑游戏详情
添加后，你可以编辑游戏详情如描述和相关图片。还可以添加成就和排行榜 – 必须在使用 Google Play 插件之前添加 – 以及配置测试和发布。
链接应用与游戏
确保完成的游戏有权访问 Google Play Game Services，你需要将你的“应用”链接到你的“游戏”。在开发者控制台编辑游戏时，点击“链接的应用”部分，接下来的步骤取决于你是作为网络应用还是安卓应用发布的。
作为网络应用发布
点击链接网络应用的按钮。你需要填写诸如播放 URL 和一些授权详情。完成后，你应该会得到一个客户端 ID。格式类似于：
12345678987-abcdefghijklmnopqrstuvwxyz1234567890.apps.googleusercontent.com
将此客户端 ID 复制并粘贴到 Google Play 插件的“客户端 ID”属性中。实际上不需要填写“应用 ID”属性，但你仍然可以添加它：应用 ID 是开发者控制台标题中出现在游戏名称旁边的数字，例如“我超级游戏 – 12345678”。在这种情况下，应用 ID 是 12345678。
作为安卓应用发布
点击链接安卓应用的按钮。你需要选择一个已经在 Google Play 注册过的应用，并提供用于签名应用程序的证书的 SHA-1 签名。确保提供了签名，并且在测试时用正确的证书签名你的应用程序很重要。除非你这样做，否则你的应用将无法登录！
完成后，你应该会获得一个客户端 ID 和应用 ID。对于安卓应用，你只需要应用 ID。格式类似于：
12345678987
将此应用 ID 复制并粘贴到 Google Play 插件的“游戏 ID”属性中。
启用预览模式访问
测试项目时，你的游戏将从 https://preview.construct.net 运行。由于这与游戏的发布 URL 不同，Google Play Game Services 将阻止访问，除非你将预览 URL 添加为允许的位置。
为此，在开发者控制台下的游戏详情中，找到标有 API CONSOLE PROJECT 的标题，并按照链接进入游戏的 API 控制台项目。在 API 控制台中，选择 APIs & auth，然后选择凭证。注意 JavaScript 来源字段只包含最终 URL；这也需要包含任何预览 URL 以允许访问。点击编辑设置。在授权的 JavaScript 来源下，确保最终 URL 和预览 URL 分别出现在不同的行上，例如：
mywebsite.com
preview.construct.net
点击更新。现在你的游戏应该被授权从预览模式以及发布时访问。
请注意，来源仅包括方案和域，不包括任何路径或文件名。
添加测试用户
在使用未发布的安卓应用时，你只能使用该应用注册的测试用户登录。要添加测试用户，请在开发者控制台编辑游戏时点击“测试”部分，点击“添加测试员”，并输入与测试设备上注册的 Google 账户关联的电子邮件地址。
基本用法
要使用 Google Play 插件，首先必须等待它完成加载。在 On loaded 触发或 Is loaded 为 true 之前，不要尝试使用插件的任何功能。
接下来，Google Play 插件会自动尝试让用户登录。如果他们之前成功登录过，On signed in 将在加载后不久触发。如果他们之前从未登录过，On auto-sign in failed 将触发；在这种情况下，你应该显示一个按钮让用户登录。当他们点击这个按钮时，使用 Sign in 动作；如果成功，On signed in 将被触发。
一旦用户登录，你就可以使用插件的其他功能，如请求排行榜、提交高分和解锁成就。
异步操作
Google Play 插件中的大多数操作都是异步的。这意味着它们不会立即完成。相反，操作开始一个请求，发送给 Google Play 服务器。片刻之后，服务器将响应，Google Play 插件中将运行一个相应的触发器。
例如，Request player details 操作不会立即完成。玩家详细信息直到 On player details received 触发后才可用，这应该在运行操作后不久发生。只有在触发器运行后，才能访问玩家详细信息。
非即时请求和缓存（仅限安卓）
Google Play Games Services 提供即时和非即时版本的大多数方法。即时方法将尝试立即在服务器上更新用户的成就 / 排行榜信息，而非即时方法只会在下次服务器同步时更新本地的 Play Games 应用。根据官方建议，我们使用可用的非即时方法。对用户来说，行为几乎完全相同，但在测试期间你可能会遇到一些缓存问题。例如，如果你正在添加新的排行榜和成就，它们可能需要一个小时才能出现在你的设备上。这并不意味着解锁成就需要一个小时！本地更改会立即出现在 Play Games 应用内，即使它未与服务器同步。
Google Play 属性
Application ID
目前这不是必需的，但可以用 Google Play 开发者控制台中的应用 ID 填充。
Client ID
来自 Google Play 开发者控制台的游戏的客户端 ID。这只对网络应用是必需的。有关更多信息，请参阅上面的 Google Play Game Services 设置部分。
Game ID
Game ID 仅用于 Android 应用。它与应用 ID 相同。有关更多信息，请参阅上面的 Google Play Game Services 设置部分。