本页介绍如何在 Unreal Engine 项目中启用 ARCore 功能。 为此,您需要:
- 将您的应用配置为 AR 必备或 AR 可选
- 确保您的应用符合 ARCore 的用户隐私权要求
面向 AR 的 Google Play 服务
在应用中启用 ARCore 的方式有两种:必需 AR 和 AR 可选。如果您需要帮助来决定选择哪一个,请参阅在 Google Play 商店中发布 AR 应用。
需要 AR
“必需 AR”意味着您的应用在没有 AR 的情况下无法使用,并且只能在支持 ARCore 的设备上使用。
如需将应用设置为 AR 必备,请选中 GoogleARCore 插件设置中的 ARCore required App 框。此设置位于 Edit > Project Settings > Plugins > GoogleARCore 菜单中。
您的应用会自动执行运行时检查,以确保设备支持 ARCore,并且安装了适用于 AR 和 ARCore 设备配置文件数据的 Google Play 服务并及时更新数据。如果 AR 版 Google Play 服务未安装(可能是因为已被用户移除)或版本太旧,或者 ARCore 设备配置文件数据不是最新的,您的应用会提示用户安装或更新这些版本。如果安装或更新失败(可能因为网络故障),Get ARCore Session Status
Blueprint 节点将返回 Error
,您的应用应处理错误并退出。
AR 可选
AR 可选表示应用可以在不支持 ARCore 的设备上安装和运行,但包含在受支持的设备上运行时启用的 AR 功能。当用户安装 AR 可选应用时,Google Play 商店不会自动安装适用于 AR 的 Google Play 服务。
如需将应用设置为 AR 可选,请在 GoogleARCore 插件设置中取消选中 ARCore required App 框。
在您的应用中,使用 Check ARCore Availability
蓝图节点检查设备是否支持 ARCore,如果支持,则检查是否安装了适用于 AR 的 Google Play 服务。
您的应用应处理以下条件:
条件 | 操作 |
---|---|
设备不支持 ARCore。 | 隐藏与 AR 相关的功能。 |
设备支持 ARCore,但 Google Play 服务未安装或已过期。 | 使用 Install ARCore Service 蓝图提示用户安装或更新。 |
设备支持 ARCore 和适用于 AR 的 Google Play 服务且是最新版本。 | 启动服务。 |
用户隐私权要求
确保您的应用符合 ARCore 的用户隐私权要求。
后续步骤
阅读示例应用和 ARCore for Unreal API 参考文档中的代码。