Unreal

本指南提供了在 Hive SDK for Unreal Engine 中设置身份验证的说明。

功能添加¶

在虚幻编辑器菜单中点击 编辑 > 项目设置。项目设置窗口将会出现。
在项目设置窗口的左侧面板中，点击 依赖项 – Android / 依赖项 – iOS，位于 Hive SDK 下面。
仅选择您希望在Hive 模块中使用的身份验证功能。
- 启用设备管理: 设备管理服务
- 启用reCAPTCHA: 使用Google reCAPTCHA进行访客登录
- 启用实名认证: 要求中国用户在拥有中国许可证的游戏中完成实名认证
- 启用Google应用内更新: Google应用内更新功能（Android）
- 启用成人确认: 成人验证服务

添加 IdP¶

在虚幻编辑器菜单中点击 编辑 > 项目设置。项目设置窗口将会出现。
在项目设置窗口的左侧面板中，点击 依赖 – Android / 依赖 – iOS，位于 Hive SDK 下。
仅选择您想在身份验证中使用的 IdP。

Note

从 Hive SDK 26.4.0 开始，Google 登录可选择 Google SignIn 或 Google Credential Manager 方式。

hive-authv4-provider-google-signin: 使用 Play Services 库处理 Google 登录。
hive-authv4-provider-google-credential-signin: 使用 Credential Manager 库处理 Google 登录。
- 需要 Gradle 8.x 或更高版本

现有基于 Play Services 库的 Google 登录已于 2024 年 9 月弃用 (Deprecated)，原计划于 2025 年移除。但目前 Google 仍继续支持该库。
为了稳定的服务运营，Google 建议从 Play Services 迁移到 Credential Manager。

Hive SDK 同时支持 Play Services 和 Credential Manager 两种方式。Google 确定移除 Play Services 的计划后，我们将通过 Hive SDK 更新进行说明。

在 hive_config.xml 中通过 IdP 输入密钥值¶

在hive_config.xml中输入从每个IdP控制台获得的密钥值。有关更多详细信息，请参阅身份验证先决条件。

Hive 配置编辑器设置¶

Hive SDK Unreal 允许您使用 Hive 配置编辑器配置 hive_config.xml。

Facebook¶

使用Facebook IdP的配置如下。

在虚幻编辑器菜单中点击 编辑 > 项目设置。项目设置窗口将会出现在屏幕上。
在项目设置窗口的左侧面板中，点击 Hive 配置 菜单。HIVEConfig XML 设置屏幕将会出现。
在 HIVEConfig XML 屏幕中，在 提供者 > AuthV4 > Facebook 字段中输入 Facebook 控制台信息。

Warning

如果您使用 Facebook IdP，由于在 Hive SDK 中自动配置以构建 Facebook 分享激活，您无法同时安装特定市场的 Android 构建（例如，Google Play 商店、One Store）。

如果您没有使用 Facebook 分享激活，请参考故障排除指南以删除 FacebookContentProvider 权限声明。

谷歌 Play 游戏¶

在虚幻编辑器菜单中点击 编辑 > 项目设置。项目设置窗口将会出现在屏幕上。
在项目设置窗口的左侧面板中，点击 Hive 配置 菜单。HIVEConfig XML 设置屏幕将会出现。
在 HIVEConfig XML 屏幕中，在 提供者 > AuthV4 > GooglePlayGames 字段中输入 Google Play 游戏控制台信息。

其他身份提供者¶

像Facebook和Google Play Games一样，在相应的 IdP字段中输入从每个IdP控制台获得的关键值 HIVEConfig XML 设置屏幕 Provider > AuthV4.

由 IdP 提供的附加设置¶

根据身份提供者（IdP），需要额外的配置。

在Unreal Android环境中使用Google Play Games认证时，以下是如何解决Hive SDK与Unreal Engine内置Google Play Games认证之间的兼容性问题。

打开以下文件。
- 虚幻引擎 4
  - ./Engine/Build/Android/Java/src/com/epicgames/ue4/GameActivity.java.template
- 虚幻引擎 5
  - ./Engine/Build/Android/Java/src/com/epicgames/ue4/GameActivity.java.template
  - ./Engine/Build/Android/Java/src/com/epicgames/unreal/psoservices/PSOProgramServiceAccessor.java

从文件中删除以下行。

import com.google.android.gms.games.Games;