登入設定

登入設定配置應用程式 ID 使用的登入資訊。

登入設定主畫面¶

• 選擇專案：僅顯示在開發或上線狀態的專案，如在應用中心中設定的。
• 應用程式 ID：列出與專案相關聯的應用程式 ID，顯示狀態，例如開發中、上線、未使用或服務終止。驚嘆號 (!) 表示具有未註冊或待處理登入設定的應用程式 ID。
• 重置：恢復到現有設定。如果設定已儲存在伺服器上，則會回退到儲存的版本。
• 變更歷史：顯示登入設定選單的變更歷史。

登入設定步驟¶

登入設定涉及三個步驟：選擇登入類型、安排登入順序和註冊認證金鑰。

1. 選擇登入方式
   • 根據在應用中心中註冊的應用程式 ID，自動顯示支援的登入類型。選擇您想要啟用的登入類型。
2. 安排登入順序
   • 根據專案需求拖曳並調整所選登入類型的順序。
3. 註冊驗證金鑰
   • 複製各個商店提供的驗證金鑰，並將其粘貼到登入設定頁面。請注意，並非所有登入方式都需要在登入設定菜單中註冊驗證金鑰；某些必須直接在 Hive SDK 中註冊。以下提供了有關為每個商店註冊驗證金鑰的詳細說明。

支援的登入類型¶

每個與 App ID 相關聯的專案必須單獨配置登入設定，並且配置取決於在 App Center 中註冊的作業系統。

行動裝置 (Android, iOS)¶

行動裝置 (Android, iOS)：支援的身份提供者包括 Google Play、Hive、Google、Facebook 等。

• 安卓 : Google Play, Hive, Facebook, Apple, Google, QQ, VK, WeChat, LINE, Weverse, Huawei, Steam, X, Telegram, XIAOMI

• iOS : 遊戲中心、Hive、Facebook、Apple、Google、QQ、VK、WeChat、LINE、Weverse、Steam、X、Telegram

PC (Windows, MacOS)¶

PC (Windows, MacOS)：支持的身份提供者包括 Hive、Google、Facebook、Apple、Line、X 和 Telegram。如果在应用中心将应用 ID 设置为 Steam 市场，则“使用 Steam 登录”是强制性的。

• 一般
• Steam 市場
  

網頁¶

網頁：支援的身份提供者包括 Hive、Google、Facebook、Apple、LINE、X、Google Play、和 Steam。

如果您使用網頁登錄，則在註冊身份驗證密鑰時必須設置重定向 URI。

重定向 URI 是用户在完成网页登录身份验证后被重定向到的页面地址，您可以注册最多五 (5) 个重定向 URI。

儲存金鑰發放與登入驗證金鑰註冊¶

要使用 IdP（身份提供者）登入，您需要每個 IdP 提供的驗證金鑰。並非所有這些金鑰都在登入設定菜單中註冊；某些 IdP 金鑰必須在 SDK 中註冊。 有關 SDK 整合，請參閱 SDK 認證指南 有關網頁登入，請參閱 網頁登入指南

使用 Google Play 登入¶

登入驗證金鑰輸入畫面¶

要使用 Google Play 進行登入，請參考以下說明以獲取客戶端 ID 和客戶端密鑰，並將其註冊在登入設定選單中。

Google Play 控制台金鑰發放與註冊流程¶

• Google Play 控制台：配置 Play 遊戲服務
  • 訪問 Google Play 控制台並使用您的 Google 帳戶登錄。導航至 Play 遊戲服務 > 設置與管理 > 配置。
  • 選擇一個 Play 遊戲服務專案。
    • 創建新專案：生成一個新的 Play 遊戲專案和雲專案。
    • 使用現有專案：重用現有專案。
  • 選擇一個雲專案。如果沒有雲專案，請點擊創建一個新的雲專案。
  • 點擊 Google Cloud 控制台以在創建 Google Cloud 專案的彈出窗口中打開 Google Cloud 控制台頁面。
• 在 Google Cloud 控制台中創建專案
  • 在 Google Cloud 控制台中創建一個新專案。
• 在 Google Cloud 控制台中設置 OAuth 同意屏幕
  • 前往 API 和服務 > OAuth 同意屏幕。選擇使用類型為「外部」，然後點擊創建。
  • 在應用註冊修改中，輸入應用名稱、用戶支持電子郵件和開發者聯繫信息，然後點擊保存並繼續。
  • 點擊保存並繼續，而不進行額外的範圍設置。
  • 點擊保存並繼續，而不進行額外的測試用戶設置。
  • 在摘要屏幕中查看設置，然後點擊返回儀表板。

• 在 Google Cloud 控制台中創建用戶憑證

  • 導航至 API 和服務 > 憑證，然後點擊創建憑證 > OAuth 客戶端 ID。
  • 應用類型：Android
    • 輸入應用類型、名稱和 SHA-1 證書指紋，然後點擊創建。參考 Google Play 服務指南
      • 包名稱可以在 AndroidManifest.xml 文件中找到。
      • 在命令提示符下使用 keytool 命令，位於 C:\Users\%USERPROFILE%.android> 以驗證 SHA-1 證書指紋。
    • 在 OAuth 客戶端創建窗口中，確認客戶端 ID。
  • 應用類型：Web 應用程序
    • 選擇 OAuth 客戶端 ID，並為 Web 應用程序類型創建額外條目。
    • 輸入應用名稱並點擊創建。
    • 在 OAuth 客戶端創建窗口中，確認客戶端 ID 和客戶端密鑰。
  Note

  • 要使用 Google Play 進行登入，請在創建用戶憑證時生成 Android 和 Web 應用程序類型。Android 應用程序類型是 Hive SDK 配置所需的，而 Web 應用程序類型則用於在登入設置菜單中註冊身份驗證密鑰。

• 在 Google Play 控制台的 Play Games Services 設定中設置雲端專案

  • 選擇一個雲端專案，點擊創建新的雲端專案，並檢查生成的專案 ID。

使用 Google 登入¶

登入驗證金鑰輸入畫面¶

要配置 Google 登入，請按照以下步驟檢索您的客戶端 ID 和客戶端密鑰，並將它們註冊在登入設置菜單中。

Google Cloud Console 金鑰發放與註冊流程¶

• 在 Google Cloud Console 中創建項目
  • 在 Google Cloud Console 中創建一個新項目。
• 在 Google Cloud Console 中設置 OAuth 同意屏幕
  • 前往 API 和服務 > OAuth 同意屏幕。選擇使用類型為「外部」，然後點擊創建。
  • 在應用註冊修改中，輸入應用名稱、用戶支持電子郵件和開發者聯繫信息，然後點擊保存並繼續。
  • 點擊保存並繼續，而不進行額外的範圍設置。
  • 點擊保存並繼續，而不進行額外的測試用戶設置。
  • 在摘要屏幕中檢查設置，然後點擊返回儀表板。

• 在 Google Cloud Console 中創建用戶憑證

  • 前往 API 和服務 > 憑證，然後點擊創建憑證 > OAuth 客戶端 ID。
  • 應用類型：Android
    • 輸入應用類型、名稱和 SHA-1 證書指紋，然後點擊創建。 參考 Google Play 服務指南
      • 包名可以在 AndroidManifest.xml 文件中找到。
      • 在命令提示符下使用 keytool 命令，位於 C:\Users\%USERPROFILE%.android> 以驗證 SHA-1 證書指紋。
    • 在 OAuth 客戶端創建窗口中，確認客戶端 ID。
  • 應用類型：Web 應用程序
    • 選擇 OAuth 客戶端 ID，並為 Web 應用程序類型創建額外條目。
    • 輸入應用名稱，然後點擊創建。
    • 在 OAuth 客戶端創建窗口中，確認客戶端 ID 和客戶端密鑰。
  Note

  • 要使用 Google 登入，您需要配置以下兩個 OAuth 2.0 客戶端 ID。
    • 網頁應用程式類型客戶端 ID : 用於在伺服器上驗證 ID 令牌
    • Android 類型客戶端 ID : 需要應用程式的包名稱和 SHA-1 證書指紋

使用 Facebook 登入¶

登入認證金鑰輸入畫面¶

要使用 Facebook 登入，請參考以下步驟以檢索應用程式 ID 和應用程式密鑰，並在登入設定選單中註冊它們。

Facebook 開發者網站金鑰發放及註冊流程¶

• 訪問並登入 Facebook 開發者網站
  • 訪問 Facebook 開發者網站並使用您的 Facebook 帳戶登入。
  • 點擊「我的應用程式」，然後選擇現有的應用程式或註冊一個新的應用程式。
• 在應用程式設定頁面檢查應用程式 ID 和應用程式密碼
  • 在應用程式儀表板中，前往設定 > 基本以查找應用程式 ID 和應用程式密碼。
  • 為了安全原因，應用程式密碼是隱藏的，顯示需要密碼。
  • 應用程式密碼僅在控制台輸入時需要，並不包含在應用程式構建中。
• 注意事項
  • 雖然以下設定在登入設定菜單中不是強制性的，但對於啟用 Facebook 登入是必需的：
    • 前往應用程式設定 > 高級設定，並啟用應用程式身份驗證。
    • 在應用程式設定 > 高級設定 > 安全性中，檢索客戶端令牌並在 Hive SDK 中配置它。
    • 前往 Facebook 登入 > 設定，並添加有效的 OAuth 重定向 URI。

使用 Apple 登入¶

登入驗證金鑰輸入畫面¶

要在 iOS 以外的平台上使用 Apple 登入，請按照以下步驟從 App Store 控制台檢索服務 ID、團隊 ID、金鑰 ID 和私鑰，並在登入設定菜單中註冊它們。

蘋果開發者網站金鑰發放與註冊流程¶

• 訪問證書、標識符和配置文件
  • 前往蘋果開發者網站，使用您的 Apple ID 登錄，然後在頂部菜單中單擊“帳戶”。導航至證書、標識符和配置文件。
• 確認服務 ID
  • 在標識符部分，前往註冊新標識符頁面，選擇服務 ID，然後單擊繼續。
  • 在註冊服務 ID 頁面中，填寫描述欄中的應用程序標題等詳細信息，並在標識符欄中輸入信息，然後單擊繼續。
  • 對於標識符，根據 Bundle ID 輸入信息以便於區分（例如，{Bundle ID}.siwa）。
  • 單擊註冊以完成服務 ID 的註冊。
• 確認團隊 ID
  • 團隊 ID 是您蘋果開發者帳戶的唯一標識符，可以在會員部分找到。
• 確認金鑰 ID
  • 在證書、標識符和配置文件中，前往金鑰部分。輸入金鑰名稱，選擇“使用 Apple 登錄”，然後單擊“繼續”。
  • 在配置金鑰頁面中，選擇要與“使用 Apple 登錄”一起使用的應用程序 ID，然後單擊“保存”。
  • 在註冊新金鑰頁面上，單擊“註冊”。
  • 在下載您的金鑰頁面中，找到金鑰 ID 並單擊“下載”以生成並下載金鑰。
• 下載私鑰
  • 私鑰文件將為 .p8 格式，且只能下載一次，因此請妥善保存。
  • 在設置中註冊私鑰時，確保包括整個內容，包括行：-----BEGIN PRIVATE KEY----- 和 -----END PRIVATE KEY-----。

使用 Apple 登入的伺服器對伺服器通知 URL 註冊程序（自 2026 年 1 月 1 日起生效）¶

自 2026 年 1 月 1 日起，使用 Apple 登入的應用程式必須**註冊一個 URL**以接收伺服器對伺服器的通知。 這些通知允許 Apple 在用戶更改郵件轉發設置、刪除應用內帳戶或永久刪除其 Apple 帳戶時向您的伺服器發送信息。

建立伺服器對伺服器通知的 URL¶

• 在 Hive 控制台 > 應用中心 > 專案管理中，找到將接收伺服器對伺服器通知的專案的遊戲索引。
• 使用識別出的遊戲索引，按照以下格式構建 URL：
  • 註冊 URL : https://auth.qpyou.cn/callback/apple/Game Index
  • 範例 : https://auth.qpyou.cn/callback/apple/539

在 Apple 開發者網站上註冊¶

• 導航至證書、標識符與配置檔
  • 使用您的 Apple ID 登入 Apple 開發者網站。
  • 從頂部菜單中，點擊帳戶，然後轉到證書、標識符與配置檔。
• 選擇您的應用程式
  • 在標識符部分，點擊要配置伺服器到伺服器通知功能的應用程式。
• 編輯 Apple 登入配置
  • 在「編輯您的應用程式 ID 配置」中，找到 Apple 登入並點擊編輯按鈕。
• 註冊伺服器到伺服器通知 URL
  • 輸入 URL 並點擊保存按鈕以完成註冊。
  • 在編輯您的應用程式 ID 配置畫面中，再次點擊保存按鈕以保存更改。

使用 HUAWEI ID 登入¶

登入驗證金鑰輸入畫面¶

要配置 HUAWEI ID 登入，請按照以下步驟檢索華為的客戶端 ID 和客戶端密鑰，並將其註冊在登入設置菜單中。

華為開發者控制台金鑰發放與註冊流程¶

• 訪問 AppGallery Connect
  • 使用您的華為帳戶登錄華為開發者控制台，然後轉到 AppGallery Connect。
  • 選擇我的專案，然後在應用儀表板中點擊專案設定。
• 在專案設定中確認 App ID 和 App Secret
  • 點擊專案設定 > 一般資訊，並檢查應用資訊 > OAuth 2.0 客戶端 ID 部分下的客戶端 ID 和客戶端密鑰。

使用 Steam 登入¶

行動裝置 (Android, iOS)¶

登入驗證金鑰輸入畫面¶

要配置 Steam 登入，請按照以下步驟檢索您的 Steam 網頁 API 金鑰並在登入設定菜單中註冊它。

Steamworks 合作夥伴網站金鑰發放與註冊流程¶

• 訪問並登錄 Steamworks 合作夥伴網站
  • 訪問 Steamworks 合作夥伴網站並使用您的 Steam 帳戶登錄。
• 驗證 Web API 金鑰
  • 在頂部菜單中，點擊「用戶與權限」下的「管理群組」列表中的群組。如果沒有群組，請點擊「創建新群組」來創建一個群組。
  • 驗證所選群組的 Web API。

PC (Windows, MacOS)¶

登入驗證金鑰輸入畫面¶

要配置 Steam 登入，請按照以下步驟檢索您的 Steam 應用程式 ID 和 Web API 金鑰，並在登入設定選單中註冊它們。

Steamworks 合作夥伴網站金鑰發放與註冊流程¶

• 確認應用程式 ID
  • 訪問 Steamworks 合作夥伴網站並使用您的 Steam 帳戶登錄。從頂部菜單中，導航至應用程式與套件 > 應用程式，並選擇現有的應用程式。
  • 應用程式 ID 顯示在應用程式的儀表板上，並唯一標識該應用程式。
• 在管理用戶與權限中確認 Web API
  • 在頂部菜單中，點擊「用戶與權限」下的「管理群組」列表中的群組。如果沒有群組，請點擊「創建新群組」以創建一個群組。
  • 驗證所選群組的 Web API。

使用 Telegram 登入¶

登入設定 認證金鑰輸入畫面¶

要使用 Telegram 登入，請參考以下說明以獲取 Bot Token 並在設定菜單中註冊它。

Telegram 金鑰發放與註冊流程¶

• 創建機器人
  1. 啟動 Telegram 應用程式，並在搜尋欄中輸入 BotFather 進行搜尋。
  2. 與 BotFather 開始聊天並輸入 /start 命令。
  3. 輸入 /newbot 命令以創建一個新的登錄處理機器人。
  4. 按順序輸入機器人名稱和用戶名。
     • 機器人名稱：用戶識別機器人的名稱（例如 MyLoginBot）。
     • 用戶名：以 _bot 結尾的唯一名稱（例如 my_login_bot）。
  5. 當機器人創建完成後，BotFather 會提供一個機器人令牌。此令牌用於通過 Telegram API 與機器人進行通信。

使用 LINE 登入¶

登入設定驗證金鑰輸入畫面¶

要使用 LINE 登入進行網頁登入，請參考以下資訊以找到您的頻道 ID 和頻道密鑰，然後在登入設定菜單中註冊它們。

發行和註冊 LINE 金鑰的步驟¶

• 創建 LINE 登入頻道
  • 登入 LINE 開發者控制台。
  • 在提供者頁面上，選擇現有的提供者或創建新的提供者。
  • 在所選的提供者下，創建 LINE 登入頻道。
• 檢查頻道 ID 和頻道密鑰
  • 前往您創建的 LINE 登入頻道的基本設置標籤。
  • 檢查頻道 ID 和頻道密鑰的值。
• 註冊回調 URL
  • 在 LINE 登入標籤中，啟用 LINE 登入。
  • 在回調 URL 欄位中，輸入網頁登入的重定向 URI。
  • 有關回調 URL 值，請參考 Hive 伺服器 API > 網頁登入整合 > 入門指南 指南。

使用 X 登入¶

登入設定認證金鑰輸入畫面¶

要使用 X 登入進行網頁登入，請參考以下資訊以找到您的客戶端 ID 和客戶端密鑰，然後在登入設定選單中註冊它們。

發行和註冊 X 金鑰的步驟¶

• 在 X 開發者控制台中創建應用
  • 登錄到 X 開發者控制台並轉到應用頁面。
  • 選擇要集成的應用或創建一個新應用。
• 配置 OAuth 2.0
  • 在選定的應用中，單擊用戶身份驗證設置（OAuth 2.0）的設置按鈕。
  • 輸入以下項目。
    • 應用權限
    • 應用類型
    • 回調 URI / 重定向 URL
      • 有關回調 URL 值，請參考 Hive Server API > 網頁登錄集成 > 入門指南。
• 檢查應用中的客戶端 ID 和客戶端密鑰
  • 保存 OAuth 2.0 設置後，將發行客戶端 ID 和客戶端密鑰。