跳轉至

所有引擎

Hive SDK 認證功能的使用需要在所有開發引擎中進行必要的設置。

Hive 控制台設定

要使用Hive SDK 认证，您需要首先在 Hive 控制台应用中心为每个 AppID 进行 IdP 设置。

Note

有关详细信息，请查看 认证 v4 IdP 设置。

hive_config.xml 設定

hive_config.xml 文件中根据您要使用的 IdP 添加认证设置。

Note

有关hive_config.xml 设置的详细信息，请参考以下内容。

項目 說明
providers 指定第三方庫的屬性值。
facebook providers 元素的子元素，定義在使用認證 v4 時的 Facebook 相關設置。 如果在使用 Facebook SDK 時需要額外的權限，除了 Hive SDK 預設的 email 權限（訪問 Facebook 帳戶電子郵件地址）和 public_profile（訪問 Facebook 公開個人資料）權限，則必須在Facebook 控制台請求該權限後將其作為元素添加到 hive_config.xml 中。 在 Hive SDK v4 Unity Windows 使用時實現 Facebook 登錄，必須在此元素中添加 id 屬性並輸入應用 ID 作為屬性值。應用 ID 可以在創建應用後在 Meta 應用儀表板中 確認。
google providers 元素的子元素，添加在使用認證 v4 時的 Google 相關設置。 要在桌面上實現 Google 登錄，必須在此元素中添加 clientId 屬性並輸入從 Google Cloud Console 獲得的 Client ID 作為屬性值。 要在 Steam Deck 上實現 Google 登錄（Hive SDK v4 Unity Windows 22.0.0 以上），必須在此元素中添加 deviceFlowClientId 屬性並輸入從 Google Cloud Console 獲得的 Client ID 作為屬性值。
wechat providers 元素的子元素，添加在使用認證 v4 時的 WeChat 相關設置。
qq 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 開發者中心獲得的 Services 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 Developer Portal 中創建的項目的 OAuth 2.0 客戶端 ID。 
<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"/>
    </providers>
</properties>

認證 Idp X 連接時的 Callback URI 設定

在認證與X連接時，設定在X Developer Portal的Callback URI需要符合Hive SDK事先定義的格式，如下所示。

hive.x.{appId}://hive.providerx
示例: hive.x.com.example.myapp://hive.providerx

此 Callback URI 需在X Developer Portal中创建的项目的 用户认证设置 / 应用信息 中进行设置。

providerx_callbackuri_setting