入门

網頁登入 API 概述¶

網頁登入 API 是一個提供網頁上 IdP（身份提供者）連接的 API。通過實現網頁登入 API，用戶可以直接從網頁上使用他們所選擇的 IdP 登入，例如 Google 或 Facebook。一般建議在外部網站（例如，由遊戲應用開發者運營的遊戲社區網站）上登入用戶，而不是在應用程式中。網頁登入 API 有兩個版本：v2 和 v1。

網頁登入 V2¶

如果您使用 Hive SDK 開發了應用程式並希望在外部網站上登入應用程式用戶， 我們建議使用網頁登入 V2。當用戶在網頁上使用他們的 IdP 帳戶 登入時，您可以通過 驗證 V2 API 獲取 IdP 識別碼 (idp_user_id)。開發者應將這些 IdP 識別碼作為外部網站用戶的帳戶識別碼，並將其存儲在外部網站數據庫中。這是因為您可以使用這個 IdP 識別碼通過 PlayerID 查詢 API 獲取 PlayerID，這是應用程式中使用的用戶識別碼。網頁登入 V2 不會直接生成 PlayerID；您必須通過 IdP 識別碼獲取 PlayerID。這樣，開發者可以將應用程式中存在的相同用戶帳戶與外部網站上的帳戶整合。

例如，遊戲應用程序開發者可以使用 Web Login V2 實現用戶使用 Google 帳戶登錄其遊戲社區網站的功能。登錄後，通過調用Verification V2 API，您可以獲得使用 Google 帳戶登錄的用戶的 IdP 標識符。如果同一用戶登錄遊戲應用程序，則會創建一個 PlayerID，即遊戲內用戶標識符。您可以使用 IdP 標識符和PlayerID 查找 API 獲得此 PlayerID。因此，開發者可以整合在遊戲社區和遊戲應用程序中存在的相同用戶帳戶。

網頁登錄 V1¶

如果您尚未使用 Hive SDK 開發應用程式並希望在外部網站上登錄應用程式用戶， 我們建議使用網頁登錄 V1。換句話說，如果您只想在應用程式外部使用 Hive SDK 提供的功能中的登錄功能，則建議使用網頁登錄 V1。當用戶使用他們的 IdP 帳戶 在網頁上登錄時，網頁登錄 V1 會立即生成一個用戶 PlayerID (pid)。開發者可以使用 PlayerID 來識別用戶，並且不需要獲取或管理像 IdP 標識符那樣的單獨標識符。

例如，遊戲應用程序開發者可以實現用戶使用 Google 帳戶通過 Web Login V1 登錄其遊戲社區的功能。當用戶使用 Google 帳戶登錄時，還會生成一個 PlayerID，因此應用程序開發者可以使用此 PlayerID 在 Hive 控制台中查找或利用用戶信息。