在 AR Foundation 应用中启用 AR（仅限 Android）

启用 AR，即可在新应用或现有应用中使用增强现实功能。

将应用配置为 AR 必备或 AR 可选

为了节省单台设备的空间，所有 AR 功能都会存储在一款名为面向 AR 的 Google Play 服务的应用中，该应用将通过 Play 商店单独更新。使用 AR 功能的 Android 应用会通过 ARCore SDK 与面向 AR 的 Google Play 服务通信。您可以通过以下两种方式配置支持 AR 功能的应用：AR 必备和 AR 可选。此标识决定了应用如何与“面向 AR 的 Google Play 服务”应用交互。

如果没有 ARCore，AR 必备应用将无法运行。它需要支持 ARCore 的设备且已安装“面向 AR 的 Google Play 服务”。

  • 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

  1. 前往 Edit > Project Settings > XR Plug-in Management > ARCore。Requirement 默认设置为 Required。

  2. 点击 Edit > Project Settings > Player，选择包含 Android 的标签页 图标。

  3. 在 Other Settings > Identification 下，指定 Minimum API Level 为 24 或更高版本。

iOS

  1. 前往 Edit > Project Settings > XR Plug-in Management > ARKit。Requirement 默认设置为 Required。

  2. 点击 Edit > Project Settings > Player，选择 iOS 标签页 图标。

  3. 在 Other Settings > Configuration 下，指定 Target minimum iOS Version。

将应用设置为 AR 可选

Android

  1. 导航到 Edit > Project Settings > XR Plug-in Management > ARCore。

  2. 从 Requirement 下拉菜单中选择 Optional 将应用设置为 AR 可选。

  3. 点击 Edit > Project Settings > Player，选择包含 Android 的标签页 图标。

  4. 在 Other Settings > Identification 下，指定 Minimum API Level 为 24 或更高版本。

iOS

  1. 导航到 Edit > Project Settings > XR Plug-in Management > ARKit。

  2. 从 Requirement 下拉菜单中选择 Optional 将应用设置为 AR 可选。

  3. 点击 Edit > Project Settings > Player，选择 iOS 标签页 图标。

  4. 在 Other Settings > Configuration 下，指定 Target minimum iOS Version。

执行运行时检查

检查是否已安装“面向 AR 的 Google Play 服务”

AR 必备应用和 AR 可选应用都必须使用 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 设备配置文件数据未安装或已过时。 提示用户安装或更新 Google Play Services for AR，以及/或者 通过调用 ARCore 设备配置文件数据 ARSession.Install()。
设备支持 ARCore 和 Google Play Services for AR，并且 ARCore 设备配置文件数据已安装并是最新的。 创建 ARCore Session 并开始使用 ARCore。

您还可以查看 ARSession.state，了解安装和支持状态。

遵守用户隐私要求

若要在 Play 商店中发布您的应用，请确保您的应用符合 ARCore 的 用户隐私要求。

后续步骤