所有引擎

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 元素所属的元素，添加用于通过认证 v4 进行身份验证时使用的 Steam 相关设置。（在 Android 和 iOS 上使用 Steam 账户登录时使用。）要在 Android 和 iOS 上实现 Steam 登录，需要在此元素内添加 `realm` 属性，并将属性值输入为 Realm。 - 输入请求登录的服务的域名（例如： https://your-app.com）。设置的值也会显示在 Steam 登录页面上。（默认值： https://withhive.com） - 请务必输入有效的域名。设置无效的域名时，正常请求可能无法进行。
x	providers 元素所属的元素，添加用于通过认证 v4 进行身份验证时使用的 X 相关设置。需要在此元素内添加 `clientId` 属性，并将属性值输入为在 X Developer Portal 上创建的项目的 OAuth 2.0 Client 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 中的回调 URI 需要符合 Hive SDK 预先定义的格式，如下所示。

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

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