入门

Web login API 概述¶

Web Login API 是一个提供网页上 IdP（身份提供者）连接的 API。通过实现 Web Login API 的登录，用户可以直接从网页上使用他们想要的 IdP（例如 Google 或 Facebook）进行登录。一般建议在外部网站（例如，由游戏应用开发者运营的游戏社区网站）上使用网页登录，而不是在应用程序中。Web Login API 有两个版本：v2 和 v1。

Web 登录 V2¶

如果您使用 Hive SDK 开发了一个应用程序并希望在外部网站上登录应用用户， 我们建议使用 Web 登录 V2。当用户使用他们的 IdP 账户 在网页上登录时，您可以通过 验证 V2 API 获取 IdP 标识符 (idp_user_id)。开发者应将此 IdP 标识符作为外部网站用户的账户标识符，并将其存储在外部网站数据库中。这是因为您可以使用 PlayerID 查找 API 通过此 IdP 标识符获取 PlayerID，这是在应用中使用的用户标识符。Web 登录 V2 不会直接生成 PlayerID；您必须通过 IdP 标识符获取 PlayerID。通过这种方式，开发者可以将应用中存在的相同用户账户与外部网站上的账户集成。

例如，游戏应用程序开发者可以使用 Web 登录 V2 实现用户使用 Google 账户登录其游戏社区网站的功能。登录后，通过调用验证 V2 API，您可以获得使用 Google 账户登录的用户的 IdP 标识符。如果同一用户登录游戏应用程序，将创建一个 PlayerID，即游戏内用户标识符。您可以通过 IdP 标识符和PlayerID 查找 API获取此 PlayerID。因此，开发者可以将存在于游戏社区和游戏应用程序中的相同用户账户集成在一起。

网络登录 V1¶

如果您没有使用 Hive SDK 开发您的应用程序，并希望在外部网站上登录应用用户， 我们建议使用网络登录 V1。换句话说，如果您希望在应用外部仅使用 Hive SDK 提供的登录功能，则推荐使用网络登录 V1。当用户使用他们的 IdP 账户 在网页上登录时，网络登录 V1 会立即生成一个用户 PlayerID (pid)。开发者可以通过 PlayerID 识别用户，无需获取或管理像 IdP 标识符那样的单独标识符。

例如，一个游戏应用开发者可以实现用户使用 Google 账户通过 Web 登录 V1 登录他们的游戏社区的功能。当用户使用 Google 账户登录时，还会生成一个 PlayerID，因此应用开发者可以使用这个 PlayerID 在 Hive 控制台中查找或利用用户信息。