在新旧应用中启用 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 现场录像。