跳转至

开始使用

网页登录 是一个允许用户通过网络登录到身份提供者（IdP）的功能。请参考支持网页登录的IdP。

使用 Web 登录 API，用户可以在外部网站（例如，由游戏开发者运营的社区网站）上实现 IdP 登录，而不是在应用程序中。目前，Web 登录 API 集成了现有的 Web 登录 v1 和 Web 登录 v2。

Warning
  • 调用Web 登录 API 版本 v2 和 v1的方法目前不受支持。要获得持续支持，您必须使用集成的 Web 登录 API。
  • 集成的 Web 登录 API 不区分版本。
Note

要使用网页登录 API，您需要在 Hive 控制台中完成相关设置。有关更多详细信息，请参阅控制台指南中“身份验证 > 登录设置”下的支持网页登录的 IdP。

如何使用网络登录API

网页登录 API 的使用因“网页登录 AppID”的目的而异。

当“Web 登录 AppID”的目的为“社区”或“网站”时

如果您在 Hive 控制台的 应用中心 > AppID 管理 > 注册 Web 登录 AppID 中选择“Web 登录 AppID”的目的为社区或网站，游戏开发者将按如下方式使用 Web 登录 API。

  1. 调用登录页面
  2. 使用用户验证和用户信息检索 API 的响应值，特别是 IdP 标识符 (idp_index, idp_user_id)，作为用户账户标识符并将其存储在开发者的数据库中

使用上述方式的原因是，如果您先在社区或网站上登录IdP，而不是在游戏中，则不会生成用于游戏的用户标识符PlayerID。通过使用IdP标识符作为用户帐户标识符，而不是PlayerID，您可以防止 帐户冲突。

然而，当用户访问游戏应用并登录时，会生成一个 PlayerID，这是游戏用户标识符。因此，它可以用作用户账户标识符，将其与 验证和用户信息检索 API 的 user_info 响应值中的 PlayerID 或 通过身份验证的用户信息检索 API 的响应值中的 PlayerID 区分开来。

Note

账户冲突发生在以下情况。

  1. 使用网页登录创建初始 IdP 和 PlayerID
  2. 使用 Hive SDK 登录游戏后，在游戏配置文件中连接额外的 IdP 集成
  3. 由于已经使用网页登录创建了 PlayerID，发生账户冲突，提示用户选择一个账户

使用“Web Login AppID”的目的是为了“区块链”

在Hive控制台中，当在应用中心 > AppID管理 > Web登录AppID注册中选择“区块链”作为“Web登录AppID”的目的时，游戏开发者使用Web登录API如下所示。

  1. 登录页面 API 调用
  2. 登录验证和用户信息检索 API 调用及响应值 PlayerID 允许用户帐户识别（无需获取和管理像 IdP 标识符这样的单独标识符）

在区块链的情况下，调用登录页面 API和登录验证及用户信息检索 API将生成一个PlayerID，因此无需使用像社区或网站这样的单独IdP标识符。