所有引擎

这提供了关于在所有开发引擎中使用 Hive SDK 认证功能所需的必要设置的指导。

Hive 控制台设置¶

要使用Hive SDK身份验证，您必须首先为每个AppID在Hive控制台身份验证中配置IdP设置。

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 元素的一个元素，添加用于 v4 身份验证的与 Apple 登录相关的设置。（用于在 Android 和 Windows 上使用 Apple 账户登录。）(+4.15.6) 要在 Android 和 Windows 上实现 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 X 时设置回调 URI¶

在与 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 设置来轻松添加它。