跳轉至

開始使用

網頁登入 是一項允許用戶通過網頁登錄IdP的功能。請參考支持網頁登入的IdP。

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

Warning
  • 單獨調用Web Login API版本v2和v1的方法目前不受支持。要獲得持續支持，您必須使用集成的Web Login API。
  • 集成的Web Login API不區分版本。
Note

要使用網頁登錄 API，您需要在 Hive 控制台中完成相關設置。欲了解更多詳情，請參閱控制台指南中的 支持網頁登錄的 IdP，該指南位於身份驗證 > 登錄設置下。

如何使用網頁登錄API

根據「網頁登入 AppID」的目的，網頁登入 API 的使用方式有所不同。

當「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 獲取用戶信息 API 的響應值中的 PlayerID 區分開來。

Note

帳戶衝突發生在以下情況中。

  1. 使用網頁登錄創建初始的 IdP 和 PlayerID
  2. 使用 Hive SDK 登錄遊戲後，在遊戲配置文件中連接額外的 IdP 集成
  3. 由於已使用網頁登錄創建了 PlayerID，發生帳戶衝突，提示用戶選擇帳戶

使用「Web 登入 AppID」的目的是為了「區塊鏈」

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

  1. 登入頁面 API 呼叫
  2. 登入驗證和用戶信息檢索 API 呼叫及其響應值 PlayerID 允許用戶帳戶識別（無需獲取和管理像 IdP 標識符這樣的單獨標識符）

在區塊鏈的情況下，調用登錄頁面 API和登錄驗證及用戶信息檢索 API將生成一個PlayerID，因此無需使用社區或網站等單獨的IdP標識符。