AR Foundation 使用入门

Unity 的 AR Foundation 是一个跨平台框架,您只需编写一次增强现实体验,然后即可针对 Android 或 iOS 设备进行构建,而无需做出任何其他更改。该框架可通过 Unity 的 AR Foundation 软件包获取。

ARCore 的可选面向 AR 基础的 ARCore 扩展软件包添加了额外的功能,让您能够使用云锚点、相机配置过滤器以及录制和播放应用中的功能。

迁移或升级现有项目

  • 如需将现有项目从(已废弃)ARCore SDK for Unity 迁移到 Unity 的 AR Foundation 和(可选)ARCore Extensions,请参阅迁移指南
  • 如需从早期版本的 AR Foundation 升级现有项目,请参阅 Unity 的升级和迁移指南

要求

根据您的目标平台,AR Foundation 软件包需要以下各项:

Android

硬件

  • 支持 ARCore 的 Android 设备或模拟器
  • 一根用于将设备连接到开发机器的 USB 线

软件

iOS

硬件

软件

安装 AR 基础

请按照以下步骤安装 AR Foundation Unity 软件包。

  1. 打开现有 Unity 项目,或创建新的 3D 项目。

  2. 导航到 Window > Package Manager

  3. 选择Packages旁边的Unity Registry

  4. 在搜索栏中输入“AR Foundation”。

  5. 点击 Install

安装并启用针对具体平台的插件软件包

AR Foundation 软件包提供了一个供 Unity 开发者使用的接口,但其本身并不实现任何 AR 功能。如需在目标设备上使用 AR Foundation,您还需要安装单独的软件包,并为每个平台启用相应的插件。

Android

借助 ARCore XR 插件软件包,您可以构建适用于 Android 设备的增强现实应用。如果您的应用以 Android 设备为目标平台,请按照以下步骤在 Unity 项目中安装该 SDK。使用与 AR Foundation 软件包相同的版本,以免出现任何兼容性问题。

  1. 在您的项目中,前往 Window > Package Manager

  2. 选择Packages旁边的Unity Registry

  3. 在搜索栏中,输入“ARCore XR plugin”。

  4. 点击 Install

  5. 前往 Edit > Project Settings。在 XR Plug-in Management 中,打开 Android 标签页并启用 ARCore

iOS

借助 ARKit XR 插件,您可以构建适用于 iOS 设备的增强现实应用。如果您的应用以 iOS 设备为目标平台,请按照以下步骤在 Unity 项目中安装该应用。使用与 AR Foundation 软件包相同的版本,以免出现任何兼容性问题。

  1. 在您的项目中,前往 Window > Package Manager

  2. 选择Packages旁边的Unity Registry

  3. 在搜索栏中输入“ARKit XR plugin”。

  4. 点击 Install

  5. 前往 Edit > Project Settings。在 XR Plug-in Management 中,打开 iOS 标签页并启用 ARKit

配置 AR 会话并向场景添加 AR 基础组件

场景需要 AR 会话才能启用 AR 进程,例如运动跟踪、环境理解和光照估测。您需要以下游戏对象以支持 AR 会话:

AR Foundation 4.x

  • AR Session:控制 AR 体验的生命周期。

  • AR Session Origin:将 AR 坐标转换为 Unity 世界坐标。

在添加新的游戏对象之前,请删除默认的 Main Camera。它将被 AR Session Origin 中的新 AR Camera 替换。

将新的 AR 游戏对象添加到您的场景中:右键点击 Hierarchy 窗格并选择 XR。添加新的 AR Session 和新的 AR Session Origin 游戏对象。

AR 基础 5.x

  • AR Session:控制 AR 体验的生命周期。

  • XR Origin:将 AR 坐标转换为 Unity 世界坐标。

在添加新的游戏对象之前,请删除默认的 Main Camera。它将被 XR Origin 中的新 AR Camera 替换。

将新的 AR 游戏对象添加到您的场景中:右键点击 Hierarchy 窗格并选择 XR。添加新的 AR Session 和新的 XR Origin 游戏对象。

配置播放器设置

Android

  1. 转到 File > Build Settings 以打开 Build Settings 窗口。
  2. Platform 下,选择 Android,然后点击 Switch Platform
  3. 点击 Player Settings
  4. 应用以下更改:

    Player Settings > …
    Other Settings > Rendering 取消选中 Auto Graphics API
    如果 Vulkan 列在 Graphics APIs 下,请将其移除,因为 ARCore 尚不支持 Vulkan。
    Other Settings > Package Name 使用 Java 软件包名称格式创建一个唯一的应用 ID。
    例如,使用 com.example.helloAR
    Other Settings > Minimum API Level 如果您要构建 AR 必备应用,请指定 Android 7.0 'Nougat' (API Level 24) or higher
    如果您要构建 AR 可选应用,请指定 Android API Level 19 or higher
    Other Settings > Scripting Backend 选择 IL2CPP(而非 Mono)以允许在下一步中启用 ARM64 支持。

    在开发过程中:

    • 使用 Mono + 32 位 (ARMv7)
    • 安装 FAT(32 位 + 64 位)ARCore APK

    寄送到 Play 商店时:

    • 使用 IL2CPP
    • 同时启用 32 位 (ARMv7) 和 64 位 (ARM64),以满足 Play 商店的 64 位要求
    • 可选(在 2018.3 及更高版本中受支持):在 Build Settings 中,启用 Android App Bundles
    Other Settings > Target Architectures 为了满足 Google Play 64 位要求,请启用 ARM64(64 位 ARM)。 使 ARMv7(32 位 ARM)保持启用状态,以支持 32 位设备。

iOS

  1. 转到 File > Build Settings 以打开 Build Settings 窗口。
  2. Platform 下,选择 iOS,然后点击 Switch Platform
  3. 点击 Player Settings
  4. 进行以下设置:

    Player Settings > …
    Other Settings > Bundle Identifier 采用反向 DNS 格式添加应用名称。
    例如,使用 com.mycompany.myapp
    Other Settings > Camera usage description 输入一段说明,解释您如何使用 AR(例如 ARKit)。
    Other Settings > Target minimum iOS version 11.0 或更高版本
    Other Settings > Architecture ARM64

后续步骤