跳轉至

所有引擎

這提供了在所有開發引擎中使用 Hive SDK 認證功能所需的必要設置指導。

Hive 控制台設定

要使用 Hive SDK 认证，您必须首先为 Hive 控制台认证中的每个 AppID 配置 身份提供者设置。

hive_config.xml 配置

hive_config.xml 文件，根據您想要使用的 IdP 添加身份驗證設置。

Note

有關 hive_config.xml 設置的更多詳細信息，請參閱 以下內容。

項目 描述
providers 指定第三方庫的屬性值。
facebook 屬於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。
google 屬於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作為屬性值。
wechat providers元素，添加用於v4身份驗證的WeChat相關設置。
qq providers元素，添加用於v4身份驗證的QQ相關設置。
vk providers元素，添加用於v4身份驗證的VK相關設置。
line providers元素，添加用於v4身份驗證的LINE相關設置。
weverse providers 元素，添加與 v4 認證相關的 Weverse 設定。
signinwithapple 屬於 providers 元素的元素，添加與 Sign-in-with-Apple 認證相關的設定，用於 v4。（用於在 Android 和 Windows 上使用 Apple 帳戶登錄。）(+4.15.6) 要在 Android 和 Windows 上實現 Sign-in-with-Apple 登錄，您需要在此元素中添加 serviceid 屬性，並將 從 Apple 開發者中心發出的服務 ID 作為屬性值輸入。
steam 此元素屬於 providers 元素，並添加與 Steam 認證相關的設定，用於 v4。（在 Android 和 iOS 上使用 Steam 帳戶登錄時使用。） 要在 Android 和 iOS 上實現 Steam 登錄，您需要在此元素中添加 realm 屬性，並將 Realm 作為屬性值輸入。
- 輸入請求登錄的服務的域名（例如，https://your-app.com）。設置的值也會顯示在 Steam 登錄頁面上。（默認值： https://withhive.com）
- 請輸入有效的域名。如果設置了無效的域名，正常請求可能無法進行。
x 此元素屬於 providers 元素，並添加與 X 認證相關的設定，用於 v4。 您需要在此元素中添加 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 開發者入口網站。

providerx_callbackuri_setting


認證 IdP 設定 Telegram 登入的機器人

要在認證中提供 Telegram 登入服務，需要一個專用的機器人。

按照以下顺序创建一个机器人并获取botId和botDomain。 有关更多信息，请参阅Telegram官方文档。

  1. 在 Telegram 中搜索 '@BotFather' 并访问带有官方认证标记的聊天室。
  2. 点击底部的开始并在聊天窗口中输入 /newbot 命令。您可以根据 BotFather 的说明输入 'name' 和 'username' 来接收认证令牌。此时，用户名无法更改，因此您必须仔细输入。获取的令牌字符串中冒号（':'）前面的数字对应于 botId。令牌是一个必须稍后输入到 Hive 控制台的值，因此请将其一起保存。
  3. 在聊天窗口中输入 /setDomain 命令。您可以设置在登录屏幕上显示的域地址。输入值用作 botDomain。
  4. 在 hive_config.xml 中输入获取的 botId 和 botDomain。如果您使用 Unity，可以通过参考 hive_config.xml 设置 来轻松添加它。