登入設定

登入設定配置應用程式 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, Google, Facebook, QQ, VK, WeChat, Apple, LINE, Weverse, Huawei, X, Steam

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

PC (Windows, MacOS)¶

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

• 一般
• Steam 市場
  

網頁¶

Web: 支援的身份提供者包括 Hive、Google、Facebook 和 Apple。對於網頁登錄，必須在身份驗證金鑰設置期間註冊重定向 URI。

存儲金鑰發放和登入身份驗證金鑰註冊¶

在登入設定菜單中註冊的身份驗證金鑰不包括 Hive 提供的所有金鑰。對於未在登入設定菜單中註冊的 IdP，請在 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

  • Android 的應用程式類型在 Hive SDK 中配置。
  • Web 應用程式的應用程式類型用於 Web、Windows 和 MacOS 的登錄設置菜單。

使用 Facebook 登入¶

登入驗證金鑰輸入畫面¶

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

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

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

使用 Apple 登入¶

登入認證金鑰輸入畫面¶

要在 iOS 以外的平台上使用 Apple 登入，請按照以下步驟從 App Store 控制台檢索 Bundle ID、Team ID、Key ID 和 Private Key，並在登入設定菜單中註冊它們。如果輸入的認證金鑰的 Bundle ID 與 App ID 不匹配，請輸入來自 Apple 開發者網站的 Bundle ID。

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

• 訪問證書、標識符和配置文件
  • 前往蘋果開發者網站，使用您的 Apple ID 登錄，然後在頂部菜單中單擊“帳戶”。導航到證書、標識符和配置文件。
• 確認 Bundle ID
  • 在證書、標識符和配置文件中，轉到標識符部分並找到您的 Bundle ID。
• 確認團隊 ID
  • 團隊 ID 是您蘋果開發者帳戶的唯一標識符，可以在會員資格部分找到。
• 確認金鑰 ID
  • 在證書、標識符和配置文件中，轉到金鑰部分。輸入金鑰名稱，選擇“使用 Apple 登錄”，然後單擊“繼續”。
  • 在配置金鑰頁面中，在主要應用 ID 欄位中選擇要與“使用 Apple 登錄”一起使用的應用 ID，然後單擊“保存”。
  • 在註冊新金鑰頁面上，單擊“註冊”。
  • 在下載您的金鑰頁面上，找到金鑰 ID 並單擊“下載”以生成並下載金鑰。
• 下載私鑰
  • 私鑰文件將為 .p8 格式，並且只能下載一次，因此請安全存儲。
  • 在設置中註冊私鑰時，確保包括整個內容，包括行：-----BEGIN PRIVATE KEY----- 和 -----END PRIVATE KEY-----。

使用 HUAWEI ID 登入¶

登入驗證金鑰輸入畫面¶

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

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

• 訪問 AppGallery Connect
  • 使用您的華為帳戶登錄華為開發者控制台，然後轉到 AppGallery Connect。
  • 選擇我的專案，然後在應用儀表板中點擊專案設定。
• 在專案設定中確認應用 ID 和應用密鑰
  • 點擊專案設定 > 一般資訊，檢查應用資訊 > 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 和網頁 API 金鑰，並在登入設定菜單中註冊它們。

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

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

使用 Telegram 登入¶

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

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

Telegram 密鑰發放與註冊流程¶

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