平台身份验证

将游戏与 Google Play 游戏服务 (PGS) 集成的第一步是实现平台身份验证。这是访问所有其他功能(例如成就、排行榜和活动)所必需的。

由于 Play 游戏服务 SDK 会在游戏启动时自动执行平台身份验证,因此您需要将 PGS v2 SDK 与游戏集成,并实现推荐的身份验证流程,以便游戏能够实现并满足 Google Play 游戏 Level Up 用户体验指南。

身份验证概念

在 Play 游戏服务 v2 中,“登录”概念分为两个不同的层:平台身份验证和游戏内身份验证。

平台身份验证

Play 游戏服务提供了一个平台互动层。它使用玩家资料管理玩家与 Google Play 游戏生态系统的关系,以访问成就、排行榜和任务等功能。平台身份验证具有以下主要特征:

  • 静默和自动:游戏启动时,身份验证会在后台自动进行。Play 游戏服务不需要手动登录按钮。
  • 玩家 ID:成功通过平台身份验证后,Play 游戏服务会提供一个稳定的玩家 ID。对于同一款游戏,此 ID 在不同设备上是一致的。此 ID 主要用于跟踪平台功能,例如成就进度。
  • 解耦:您不得将 Play 游戏服务用作游戏的主要身份系统来管理玩家的游戏内账号 (IGA)、游戏进度或物品清单。Play 游戏服务可用作永久性平台标识符。

玩家 ID

玩家 ID 是 Play 游戏服务玩家账号的标识符。您的游戏可以检索使用 Play 游戏服务身份验证功能登录游戏的任何玩家的玩家 ID。您的游戏客户端集成、游戏服务器集成和云端存档服务可以使用玩家 ID 安全地访问 Play 游戏服务中的玩家数据。

当用户在多个设备上玩同一款游戏时,玩家 ID 是一致的。但是,不同游戏之间不一定会始终保持一致。 如需了解详情,请参阅新一代玩家 ID。

游戏内身份验证

您负责管理游戏内账号 (IGA),该账号是绑定玩家在游戏中的进度、道具和货币的身份系统。

  • 主要身份:您可以使用自己的后端、使用 Google 账号登录 (SiWG) 或其他提供方作为主要登录方式。
  • 独立性:玩家可以登录 Play 游戏服务(平台身份)来获得成就,同时登录任何特定的 IGA(例如访客账号或特定的 SiWG 账号)。
  • 管理多个 IGA:Play 游戏服务仅处理平台身份验证。您的游戏会管理玩家登录其 IGA 的主要身份验证。这意味着,您游戏现有的玩家切换 IGA 流程不会发生变化。当玩家切换账号时,他们仍会通过 PGS 在 Play 游戏平台上进行身份验证,而您会继续针对永久性玩家 ID 发送与成就和其他 PGS 功能相关的数据。

使用 SiWG 实现跨平台连续性

为了帮助玩家在 Android、iOS 和 Web 平台上同步游戏进度,请使用使用 Google 账号登录作为主要的游戏内身份验证方法。请考虑以下事项:

  • “使用 Google 账号登录”按钮:在 PGS v1 中,Google Play 按钮通常会同时处理平台和游戏登录。在 v2 中,这些是单独的流程。 实现标准的使用 Google 账号登录按钮,以便玩家进行身份验证并访问其 IGA。
  • Google 登录 SDK:
    • 对于 Android 和 iOS,请使用标准 Google 登录 SDK 对玩家进行身份验证,以便他们登录其 IGA。
    • 将 Google Open ID 用作玩家游戏内账号的主要标识符。
    • 使用 Play 游戏服务玩家 ID 报告玩家在 Play 游戏功能(例如成就)方面的进度。

推荐的集成

如需将游戏与 Play 游戏服务集成,请按照以下推荐步骤操作:

初始化和身份验证

您必须执行此步骤才能初始化游戏并进行身份验证:

在启动时初始化 Play 游戏服务 v2 SDK,以实现平台身份验证。如需了解详情,请参阅适用于 Android 游戏的平台身份验证机制。 您必须完成此步骤,才能使用 Play 游戏服务功能,例如成就和排行榜。

身份验证会在游戏启动期间作为静默后台进程运行。现有的 Play 游戏服务用户在成功通过身份验证后会看到欢迎消息。系统会在 SDK 初始化期间提示没有 Play 游戏服务玩家资料的用户创建玩家资料。

自动登录提示

创建个人资料

玩家需要有 Play 游戏服务玩家资料才能使用该平台。有些玩家在开始玩您的游戏时可能没有 Play 游戏服务玩家资料。系统会要求这些玩家创建一个玩家资料。 您可以从以下选项中选择一个,为用户提供合适的体验:

自动触发的玩家资料创建提示

默认情况下,如果您在没有 Play 游戏服务玩家资料的情况下启动游戏,系统会自动显示自动触发的玩家资料创建提示。

启动游戏时,系统会提示您创建玩家资料。
启动游戏时的玩家资料创建提示(点击可放大)。

停止自动触发的玩家资料创建提示

通过配置清单文件来停用自动触发的提示,从而在启动时停用玩家资料提示。这样,没有 Play 游戏服务玩家资料的用户就可以继续加载游戏,而不会收到创建 Play 游戏服务玩家资料的提示。

虽然用户可以使用任何身份提供方登录,但您应显示玩家资料创建提示,鼓励他们使用 Play 游戏平台身份验证进行身份验证。根据需要显示此提示,但请确保在用户在成就和排行榜等功能中取得重大进展之前显示此提示。

建议在以下时刻触发玩家档案提示:

  • 完成教程后。
  • 在奖励时刻(例如,赢得比赛、收集稀有物品或达到里程碑)。
  • 启动第二个会话时。

如需了解详情,请参阅阻止自动触发的玩家资料创建 (Java) 和阻止自动触发的玩家资料创建 (Unity)。

游戏内身份验证

成功执行平台身份验证后,开发者应根据当前游戏状态,执行以下步骤,以便玩家访问其 IGA:

  1. 如果设备上存在活跃的游戏会话,请允许玩家继续当前会话。
  2. 如果不存在活跃的游戏会话:
    1. 在无缝恢复场景中,如果上次玩的 IGA 与 PGS 玩家 ID 相关联,则继续自动恢复关联的 IGA。
    2. 否则,请向玩家显示应用的指定登录或账号创建界面。然后,玩家可以选择自己偏好的身份验证方法来创建或登录现有 IGA。

OAuth 范围

Play 游戏服务依赖 OAuth 系统来允许玩家授权您的游戏访问他们的账号。Play 游戏服务针对游戏提供唯一范围 (games-lite),如果您的游戏使用游戏存档功能,将依赖另一个范围 (drive.appdata)。通过游戏存档功能,您可以访问用户的 Google 云端硬盘账号,游戏数据便存储在此处。

使用 Play 游戏服务 v2 SDK 时,您可以请求额外的 OAuth 范围。如果您需要额外的 OAuth 范围,我们建议您调用 requestServerSideAccess。 如需了解详情,请参阅获取服务器授权代码或检索服务器授权代码。

理想身份验证流程的用户体验指南

以下指南介绍了集成 PGS v2 时推荐的身份验证流程。这些场景涵盖新用户、现有用户、回访用户和访客模式。

新建玩家

此流程适用于用户首次在设备上启动游戏,且之前没有该游戏的游戏记录。

  1. 启动后,PGS SDK 会进行初始化,以验证用户的平台身份(PGS 玩家 ID)。
  2. 完成此后台握手后,游戏会向玩家显示 IGA 创建选项,例如创建新账号、使用 Google 账号登录或其他社交登录方法。
  3. 玩家创建或选择 IGA 后,游戏会将此账号与其后端中选择的主要标识符绑定。
  4. 游戏还会将此所选 IGA 绑定到 PGS 玩家 ID,并将其标记为上次玩过的 IGA,以便无缝恢复。
新玩家已登录 PGS 玩家资料
已登录 PGS 玩家资料的新玩家(点击可放大)。
没有 PGS 玩家资料的新玩家
没有 PGS 玩家资料的新玩家(点击可放大)。
新玩家已登录 PGS 玩家资料
已登录 PGS 玩家资料的新玩家(点击可放大)。

活跃会话中的玩家

此场景描述的是玩家在已有活跃会话的设备上启动游戏。我们的目标是提供顺畅的进入体验。

  1. 当玩家启动应用时,PGS 会在后台静默进行身份验证,为您提供玩家 ID,以便您跟踪成就和其他 Play 游戏功能的进度。
  2. 同时,在适用的情况下,游戏会绕过登录界面,立即让玩家登录其活跃的 IGA 会话或与其玩家 ID 关联的上次玩的 IGA,以便他们可以立即继续游戏。
在同一设备上启动游戏,并登录 PGS 玩家资料
在同一设备上使用已登录的 PGS 玩家资料启动游戏(点击可放大)。
在同一设备上启动游戏,并退出 PGS 玩家资料
在同一设备上使用已退出登录的 PGS 玩家资料启动游戏(点击可放大)。
在同一设备上启动游戏,但没有 PGS 玩家资料
在同一设备上启动游戏,但没有 PGS 玩家资料(点击可放大)。
在新设备上启动游戏,并使用已登录的 PGS 玩家资料和关联的 IGA
在新设备上启动游戏,并使用已登录的 PGS 玩家资料和关联的 IGA(点击可放大)。
在新设备上启动游戏,此时已登录 PGS 玩家资料,但未关联 IGA
在新设备上启动游戏,使用已登录的 PGS 玩家资料,且未关联 IGA(点击可放大)。
在新设备上启动游戏,并退出 PGS 玩家资料
在新设备上启动游戏,并使用已退出的 PGS 玩家资料(点击可放大)。
在新设备上启动游戏,且没有 PGS 玩家资料
在新设备上启动游戏,但没有 PGS 玩家资料(点击可放大)。

玩家切换账号

当具有活跃会话的玩家前往游戏设置切换账号时,会发生此流程。 例如,退出主账号以使用备用账号。

  1. 玩家退出当前 IGA,但 PGS 平台连接仍处于活跃状态。
  2. 当玩家使用其他 IGA 登录时,游戏会将此新账号绑定到当前 PGS 玩家 ID,作为上次玩过的 IGA,仅用于无缝恢复。
切换到未与任何 PGS 玩家资料绑定的 IGA
切换到未与任何 PGS 玩家资料绑定的 IGA(点击可放大)。
切换到与已登录的同一 PGS 玩家资料绑定的 IGA
切换到与已登录的同一 PGS 玩家资料绑定的 IGA(点击可放大)。
切换到与不同 PGS 玩家资料绑定的 IGA
切换到与不同 PGS 玩家资料绑定的 IGA(点击可放大)。
在设备上切换没有 PGS 玩家资料的 IGA
在设备上没有 PGS 玩家资料的情况下切换 IGA(点击可放大)。
切换到已退出 PGS 玩家资料的 IGA
切换到已退出登录的 PGS 玩家资料的 IGA(点击可放大)。
切换到不存在的 IGA
切换到不存在的 IGA(点击可放大)。

为回归玩家提供无缝恢复功能

此场景适用于玩家在一段时间不活跃后、重新安装后或在全新设备上启动游戏的情况。建议游戏实现无缝恢复。

  1. 启动后,PGS 会对用户进行身份验证,并向游戏提供 PGS 玩家 ID。
  2. 游戏会检查其后端(或检索到的 Recall 令牌,如果使用 Recall API),以查看上次玩游戏时使用的 IGA 是否已与此 PGS ID 相关联。
  3. 如果找到关联,游戏会自动恢复玩家的进度并让其登录,从而完全跳过手动登录界面。
  4. 否则,游戏会向玩家显示登录界面
    1. 然后,玩家选择登录方法并登录 IGA
    2. 然后,游戏会将此 IGA 与 PGS 玩家 ID 绑定,作为上次玩过的 IGA,以便进行无缝恢复。
已退出 PGS 玩家资料的老玩家
PGS 玩家资料已退出的老玩家(点击可放大)。
老玩家,已登录 PGS 玩家资料并关联了 IGA
已登录 PGS 玩家资料并关联了 IGA 的回访玩家(点击可放大)。
回访玩家,已登录 PGS 玩家资料,但未关联 IGA
已登录 PGS 玩家资料且未关联 IGA 的回访玩家(点击可放大)。
没有 PGS 玩家资料的回访玩家
没有 PGS 玩家资料的回访玩家(点击可放大)。

访客模式

玩家可以使用本地访客账号启动并玩游戏。 Play 游戏服务仍会在后台对玩家进行身份验证。如果玩家选择保存进度,您的游戏会将访客会话转换为永久 IGA,并将其绑定到玩家 ID。如需详细了解冲突解决,请参阅访客账号。

访客模式 - 未创建 IGA
访客模式 - 未创建 IGA(点击可放大)。
访客模式 - 已创建 IGA
访客模式 - 已创建 IGA(点击可放大)。

测试游戏

通过测试确保游戏功能符合设计预期。您执行的测试取决于游戏的功能。

下面列出了要运行的常见测试。

  1. 成功登录。

    1. 自动登录功能正常。用户应在启动游戏时登录 Play 游戏服务。

    2. 系统会显示欢迎弹出式窗口。

      欢迎弹出式窗口示例。
      欢迎弹出式窗口示例(点击可放大)。

    3. 系统会显示成功日志消息。在终端运行以下命令:

      adb logcat | grep com.google.android.

      以下示例显示了一条成功日志消息:

      [$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc
      number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup.
      [CONTEXT service_id=1 ]
  2. 确保界面组件的一致性。

    1. 在 Play 游戏服务界面 (UI) 中,弹窗、排行榜和成就在各种屏幕尺寸和屏幕方向下都能正确且一致地显示。

    2. Play 游戏服务界面中不显示退出选项。

    3. 确保您可以成功检索玩家 ID,并且服务器端功能(如果适用)按预期运行。

    4. 如果游戏使用服务器端身份验证,请全面测试 requestServerSideAccess 流程。确保服务器收到授权代码,并能用其换取访问令牌。 测试网络连接错误、client ID 无效等成功和失败场景。

如果您的游戏使用了以下任何功能,请对其进行测试,以确保其运行方式与迁移前相同:

  • 排行榜:提交得分并查看排行榜。检查玩家名称和得分的排名和显示是否正确。
  • 成就:解锁成就,并验证它们是否已正确记录并显示在 Play 游戏界面中。
  • 游戏存档:如果游戏使用游戏存档,请确保游戏进度的保存和加载功能正常运行。在多台设备上以及应用更新后进行测试尤为重要。