在 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 必备应用将无法运行。它需要安装了“面向 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.state 下载并安装 ARCore。
Android minSdkVersion 要求 Android 7.0(API 级别 24) Android 4.4(API 级别 19),但运行任何 AR 功能至少需要 Android 7.0(API 级别 24)
必须使用 ARSession.state 检查 ARCore 支持和安装状态

将您的应用设为 AR 必备应用

Android

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

  2. 点击 Edit > Project Settings > Player,选择带有 Android 图标的标签页。

  3. Other Settings > Identification 下,指定不低于 24Minimum API Level

iOS

  1. 前往 Edit > Project Settings > XR Plug-in Management > ARKitRequirement 默认设置为 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 下,指定不低于 24Minimum API Level

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.state,然后再创建 ARCore 会话,以检查是否(仍然)安装了面向 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 的用户隐私要求

后续步骤