在 AR Foundation 应用中启用 AR(仅限 Android)

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

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

为了节省单台设备的空间,所有 AR 功能都会存储在一款名为面向 AR 的 Google Play 服务的应用中,该应用将通过 Play 商店单独更新。使用 AR 功能的 Android 应用使用 ARCore SDK 与 Google Play 服务 AR 版进行通信。支持 AR 功能的应用可通过两种方式进行配置:AR 必备AR 可选。此指定决定了应用与 Google Play 服务(面向 AR)应用的互动方式。

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

  • Google Play 商店只会在支持 ARCore 的设备上提供 AR 必备应用。
  • 当用户安装 AR 必备应用时,Google Play 商店会自动在其设备上安装“面向 AR 的 Google Play 服务”。不过,您的应用仍必须执行额外的运行时检查,以防 Google Play 服务(AR 版)已过时或已被手动卸载。

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 > 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.Install() 协程,然后再创建 ARCore 会话,以检查是否(仍)安装了兼容版本的 Google Play 服务(面向 AR),并确保已下载所有必需的 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 的用户隐私权要求

后续步骤