登入設定

登入設定配置應用程式 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、Line、X 和 Telegram。如果在應用中心將應用程式 ID 設定為 Steam 市場，則必須使用「Steam 登入」。

• 一般
• Steam 市場
  

網頁¶

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

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

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

使用 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和Web API金鑰，並在登入設定菜單中註冊它們。

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

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

使用 Telegram 登入¶

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

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

Telegram 金鑰發放和註冊流程¶

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