AR 项目创建

参照以下步骤完成对项目的 AR 相关特性配置。

以下提供三种方法，可以任选一种来配置扩展或直接打开内置 AR 项目。

方法一：将 xr-plugin 应用到项目

在 Cocos Store 中搜索 xr-plugin，获取扩展并安装，具体安装说明请参考 说明。

安装完毕后将扩展添加至对应工程。

这种方式适合为存量 3D 项目做 XR 模式迁移。

search-in-store

install-for-proj

方法二：创建 AR 模板工程

Dashboard 中新建项目，编辑器版本选择 v3.7.1 或更高，模板类别下选择 Empty(AR Mobile) 进行创建。

create-by-template

打开项目，进入 scene 场景。场景已经包含初始的 AR Camera 配置，可以直接进行功能开发。

open-ar-template

创建 AR 案例

Dashboard 中新建项目，编辑器版本选择 v3.7.1 或更高，案例类别下选择 AR(移动端) 案例进行创建。

create-by-ar-example

案例项目中包含当前版本扩展完整的有关AR特性功能的内容，可以直接进行构建打包体验。AR 应用的构建发布相关说明请查阅 构建与发布。

方法三：场景配置

若采用第一种将 xr-plugin 应用到项目的方式配置插件，还需进行以下步骤对普通的 3D 场景完成 AR 功能的基本配置。

应用中的每个 AR 场景中必须要包含两个关键对象：XR Agent和AR Camera。

推荐以下两种方式任选一种来进行场景配置：

  1. 右键单击 层次管理器 窗口，选择 创建 XR -> XR Agent。选中 XR Agent 节点，右键创建 Empty Node，并重命名为 TrackingSpace。选中 TrackingSpace 节点，右键创建 XR -> AR Camera。

    create-ar-camera

    选中 XR Agent 节点，在属性检查器中点击“添加组件”，添加 XR -> AR Tracking -> ARSession 和 XR -> AR Tracking -> ARManager。

    set-ar-comp

  2. 对于空场景或现有项目，可以直接选中场景中主摄像机，右键选择转为 AR Camera，即可得到上述默认的结构。

    convert-to-ar-camera

XR Agent 和 AR Camera 及其组件在 AR 项目中扮演着重要的角色。要更详细地了解它们，请分别查阅 设备映射 和 AR相机。

Spaces平台项目场景设置

新建空场景，将场景中 Main Camera 右键选择转为 XR HMD。

选中 XR Agent，点击 Add Component 添加 ARSession 和 ARManager 组件。

spaces-add-ar-comp

可以参考 平面追踪 和 图像追踪 给应用做AR赋能。

功能开发完成后可直接打包发布。

在 Dashboard 的 VR 案例中，提供了一个简易的 Spaces 专用场景，可以直接打包应用并将此场景设为启动场景。

open-spaces-example

build-spaces

具体有关高通 Spaces 平台的 AR SDK 请参考 这里。