所有引擎
這提供了在所有開發引擎中使用 Hive SDK 認證功能所需的必要設置指導。
Hive 控制台設置¶
要使用 Hive SDK 身份驗證，您必須首先為 Hive 控制台身份驗證中的每個 AppID 配置 IdP 設定。
hive_config.xml 配置¶
hive_config.xml 檔案中，根據您想要使用的 IdP 添加身份驗證設置。
Note
有關 hive_config.xml 設置的更多詳細信息，請參閱 以下內容。
| 項目 | 描述 |
|---|---|
| providers | 指定第三方庫的屬性值。 |
屬於providers元素的一個元素，定義用於v4身份驗證的Facebook相關設置。 如果需要超出Hive SDK在使用Facebook SDK時設置的默認電子郵件權限（訪問Facebook帳戶電子郵件地址）和public_profile（訪問Facebook公共資料）的其他權限，您必須在Facebook控制台中請求這些權限並將其作為元素添加到hive_config.xml中。 在使用Hive SDK v4 Unity Windows時實現Facebook登錄，您需要在此元素內添加id屬性並輸入應用程序ID作為屬性值。您可以在創建應用程序後在Meta應用程序儀表板中找到應用程序ID。 | |
屬於providers元素的一個元素，添加用於v4身份驗證的Google相關設置。 在桌面上實現Google登錄，您需要在此元素內添加clientId屬性並輸入從Google Cloud Console發出的客戶端ID作為屬性值。 在Steam Deck（Hive SDK v4 Unity Windows 22.0.0或更高版本）上實現Google登錄，您需要在此元素內添加deviceFlowClientId屬性並輸入從Google Cloud Console發出的客戶端ID作為屬性值。 | |
| providers元素，添加用於v4身份驗證的WeChat相關設置。 | |
| providers元素，添加用於v4身份驗證的QQ相關設置。 | |
| vk | providers元素，添加用於v4身份驗證的VK相關設置。 |
| line | providers元素，添加用於v4身份驗證的LINE相關設置。 |
| weverse | providers 元素，添加用於 v4 認證的 Weverse 相關設置。 |
| signinwithapple | 屬於 providers 元素的元素，添加用於 v4 認證的 Sign-in-with-Apple 相關設置。（用於在 Android 和 Windows 上使用 Apple 帳戶登錄。）(+4.15.6) 要在 Android 和 Windows 上實現 Sign-in-with-Apple 登錄，您需要在此元素內添加 serviceid 屬性，並將從 Apple 開發者中心發出的服務 ID 作為屬性值輸入。 |
| steam | 此元素屬於 providers 元素，並添加用於 v4 認證的 Steam 相關設置。（用於在 Android 和 iOS 上使用 Steam 帳戶登錄。） 要在 Android 和 iOS 上實現 Steam 登錄，您需要在此元素內添加 realm 屬性，並將 Realm 作為屬性值輸入。 * 輸入請求登錄的服務的域名（例如，https://your-app.com）。設置的值也將顯示在 Steam 登錄頁面上。（默認值： https://withhive.com） * 請輸入有效的域名。如果設置了無效的域名，正常請求可能無法進行。 |
| x | 此元素屬於 providers 元素，並添加用於 v4 認證的 X 相關設置。 您需要在此元素內添加 clientId 屬性，並將在 X 開發者門戶 中創建的項目的 OAuth 2.0 客戶端 ID 作為屬性值輸入。 |
| telegram | 此元素屬於 providers 元素，並添加用於 v4 認證的 Telegram 相關設置。 在此元素內添加 botId 和 botDomain 屬性。 每個屬性是通過 Telegram 的 @BotFather 創建的自定義機器人的 botId 和 botDomain。 botId 是必需的，如果未設置 botDomain，則默認值設置為 'https://auth.qpyou.cn'。該域名將顯示在 Telegram 登錄屏幕上。 |
<properties>
<providers>
<!-- 아래 Facebook 코드는 Hive SDK에서 자동으로 설정하는 email 권한, public_profile 권한 외에 다른 권한들(예를 들면 user_friends, user_gender)이 추가로 필요할 때 이를 위해 설정하는 예시입니다.-->
<!-- 실제로 hive_config.xml을 사용할 때에는, 게임사가 필요로 하는 권한만을 <permission> 요소로 삽입해야 합니다. -->
<facebook id="1809615065921877">
<permissions>
<permission name="user_friends" />
<permission name="user_gender" />
</permissions>
</facebook>
<google playAppId="123456789012" clientId="123456789012-abc.apps.googleusercontent.com" serverClientId="123456789012-abc.apps.googleusercontent.com" reversedClientId="com.googleusercontent.apps.123456789012-abc" deviceFlowClientId="331526026701-gn1abq1ev23nqj7rdvvlaamf7ii4f3u9.apps.googleusercontent.com" />
<googleplaygames playAppId="123456789012" clientId="123456789012-abc.apps.googleusercontent.com" serverClientId="123456789012-abc.apps.googleusercontent.com" reversedClientId="com.googleusercontent.apps.123456789012-abc" />
<qq id="1234567890" />
<vk id="1234567" />
<wechat id="wx12345cf6c789c0f1" secret="abcdefg" univeralLink="https://your.sample.com/"/>
<line channelId="1234567890" />
<weverse clientId="abcdefg" />
<!-- (Android Only) 애플 개발자 계정에서 설정한 서비스 id를 serviceid로 설정 -->
<signinwithapple serviceid="com.sample.your" />
<!-- (Android&iOS) Steam 로그인 서비스 범위 설정. (기본 값: https://withhive.com) -->
<steam realm="https://your-app.com"/>
<x clientId="ABCDEFG"/>
<telegram botId="123456789" botDomain="https://auth.qpyou.cn"/>
</providers>
</properties>
設定整合 Idp 的回呼 URI X¶
在與 X 進行身份驗證集成時，在 X 開發者門戶 中設置的回調 URI 需要 Hive SDK 預定義的格式，如下所示。
hive.x.{appId}://hive.providerx
範例: hive.x.com.example.myapp://hive.providerx
此回調 URI 設定在 用戶身份驗證設定 / 應用程式資訊 中，該專案是在 X 開發者入口網站 中創建的。
認證 IdP 設定 Telegram 登入機器人¶
要在身份驗證中提供 Telegram 登錄服務，需要一個專用的機器人。
按照以下顺序创建一个机器人并获取botId和botDomain。 有关更多信息，请参阅Telegram官方文档。
- 在 Telegram 中搜索 '@BotFather'，并访问带有官方认证标志的聊天室。
- 点击底部的开始，并在聊天窗口中输入
/newbot命令。根据 BotFather 的指示输入 'name' 和 'username' 后，您可以收到认证令牌。此时，用户名无法更改，因此必须仔细输入。在获取的令牌字符串中，冒号 (':') 前的数字对应于 botId。该令牌是稍后必须输入到 Hive 控制台中的值，因此请一起保存。 - 在聊天窗口中输入
/setDomain命令。您可以设置在登录屏幕上显示的域地址。输入的值用作 botDomain。 - 在 hive_config.xml 中输入获取的 botId 和 botDomain。如果您使用 Unity，可以通过参考 hive_config.xml 设置 来轻松添加。