在新旧应用中启用 AR 功能,即可使用增强现实功能。
将您的应用配置为 AR 必备或 AR 可选
为了节省个别设备上的空间,所有 AR 功能都存储在名为面向 AR 的 Google Play 服务的应用中,该应用由 Play 商店单独更新。使用 AR 功能的 Android 应用通过 ARCore SDK 与面向 AR 的 Google Play 服务进行通信。支持 AR 功能的应用可通过以下两种方式配置:AR 必备和 AR 可选。此指定决定了应用如何与“面向 AR 的 Google Play 服务”应用交互。
AR 必备应用如果没有 ARCore,则无法正常运行。它需要一台已安装“面向 AR 的 Google Play 服务”的支持 ARCore 的设备。
- Google Play 商店只会在支持 ARCore 的设备上提供 AR 必备应用。
- 当用户安装 AR 必备应用时,Google Play 商店会自动在其设备上安装“面向 AR 的 Google Play 服务”。不过,即使面向 AR 的 Google Play 服务已过时或已被手动卸载,您的应用仍必须执行额外的运行时检查。
AR 可选应用使用 ARCore 增强现有功能。它具有可选的 AR 功能,这些功能只能在安装了面向 AR 的 Google Play 服务的 ARCore 支持设备上激活。
- AR 可选应用可在不支持 ARCore 的设备上安装和运行。
- 当用户安装 AR 可选应用时,Google Play 商店不会在设备上安装“面向 AR 的 Google Play 服务”。
需开启 AR | AR 可选 | |
---|---|---|
AR 功能使用情况 | 您的应用需要 ARCore 才能实现基本功能。 | ARCore 可以增强应用的功能。您的应用可以在不支持 ARCore 的情况下运行。 |
Play 商店公开范围 | 您的应用仅在支持 ARCore 的设备上的 Play 商店中上架。 | 您的应用遵循了常规的上架程序。 |
“面向 AR 的 Google Play 服务”安装方法 | Play 商店会随您的应用一起安装“面向 AR 的 Google Play 服务”。 | 您的应用使用 ARSession.Install() 协程下载并安装 ARCore。 |
Android minSdkVersion 要求 |
Android 7.0(API 级别 24) | Android 4.4(API 级别 19),不过,运行任何 AR 功能至少需要 Android 7.0(API 级别 24) |
必须使用 ARSession.state 来检查 ARCore 支持和安装状态
|
||
必须使用 ARSession.Install() 协程安装“面向 AR 的 Google Play 服务” |
将应用设为 AR 必备
Android
前往 Edit > Project Settings > XR Plug-in Management > ARCore。Requirement 默认设为 Required。
点击 Edit > Project Settings > Player,选择带有 Android 图标的标签页。
在 Other Settings > Identification 下,指定一个不低于
24
的 Minimum API Level。
iOS
前往 Edit > Project Settings > XR Plug-in Management > ARKit。Requirement 默认设为 Required。
点击 Edit > Project Settings > Player,选择带有 iOS 图标的标签页。
在 Other Settings > Configuration 下,为您的应用指定 Target minimum iOS Version。
将应用设为 AR 可选
Android
进入“Edit > Project Settings > XR Plug-in Management > ARCore”。
从 Requirement 下拉菜单中选择 Optional,将应用设置为 AR 可选应用。
点击 Edit > Project Settings > Player,选择带有 Android 图标的标签页。
在 Other Settings > Identification 下,指定一个不低于
24
的 Minimum API Level。
iOS
进入“Edit > Project Settings > XR Plug-in Management > ARKit”。
从 Requirement 下拉菜单中,选择 Optional 以将您的应用设置为 AR 可选。
点击 Edit > Project Settings > Player,选择带有 iOS 图标的标签页。
在 Other Settings > Configuration 下,为您的应用指定 Target minimum iOS Version。
执行运行时检查
检查是否已安装“面向 AR 的 Google Play 服务”
AR 必备应用和 AR 可选应用都必须在创建 ARCore 会话之前使用 ARSession.Install()
协程来检查是否(仍然)安装了面向 AR 的 Google Play 服务的兼容版本,并确保已下载所有必需的 ARCore 设备配置文件数据。
在运行时,AR 必备应用将自动执行运行时检查,以确保目标设备:
- 支持 ARCore
- 已安装 Google Play Services for AR - 如果未安装(可能因为它已被用户移除)或版本太低,您的应用将提示用户安装或更新。
- 具有最新的 ARCore 设备配置文件数据 - 如果数据已过时,您的应用将下载新的数据。
将 ARSession.attemptUpdate
设置为 false
可停用这些默认检查。您的应用仍应处理以下条件:
条件 | 操作 |
---|---|
设备不支持 ARCore。 | 隐藏 AR 相关功能。 |
设备支持 ARCore,但 Google Play Services for AR 和/或 ARCore 设备配置文件数据未安装或已过时。 | 通过调用 ARSession.Install() 提示用户安装或更新 Google Play Services for AR 和/或 ARCore 设备配置文件数据。 |
设备支持 ARCore 和 Google Play Services for AR,并且 ARCore 设备配置文件数据已安装并是最新版本。 | 创建 ARCore Session 并开始使用 ARCore。 |
您也可以查看 ARSession.state
,了解安装和支持状态。
遵守用户隐私要求
如需在 Play 商店中发布您的应用,请确保您的应用符合 ARCore 的用户隐私要求。
后续步骤
- 了解如何配置 ARCore 现场录像。