Meta XR/Quest 工程配置方法

本章介绍如何配置 Unity 工程使其在 Meta XR/Quest 头显上使用 EasyAR 的相关功能。

准备工作

学习如何使用头显样例
获取适合 XR 头显的 EasyAR 许可证
- EasyAR Sense 4.x XR License 试用版（试用，在 EasyAR 网站自主开通）
- EasyAR Sense 4.x XR License 正式版（付费后使用）
- EasyAR Sense 4.x XR License 企业版（企业版 SDK 使用）
使用示例场景时，如果使用 URP，应先更新示例中的 URP 资产
参考 Android 工程配置

导入 MRUK (Mixed Reality Utility Kit)

使用 Package Manager window 导入 com.easyar.sense.ext.meta.xr，会自动导入 MRUK。

如果需要指定 MRUK 版本，可以参考 Meta 官方文档，在 Packages/manifest.json 中添加 com.meta.xr.mrutilitykit。

比如，如果要使用 205 版本，可以添加：

  "com.meta.xr.mrutilitykit": "205.0.0",

注意

MRUK 会自动引入 Meta XR Core SDK
EasyAR 不依赖其它 Meta 包，可以根据实际使用需要进行添加

配置 Meta XR/Quest 通用开发环境

参考 Meta 入门文档进行配置。需要注意以下内容：

安装 XR Plugin Management 并启用 OpenXR。
切换到 Meta Quest 平台（Unity < 6.1 使用 Android 平台）。
使用 Project Setup Tool 更新配置，在 Meta (Android) 页面中点击 Fix All 和 Apply All。
使用 Project validation 更新配置，在 Meta (Android) 页面中点击 Fix All。

启用 Passthrough

如果场景中没有 OVR Passthrough Layer 组件，先添加。

alt text

提示

在场景中创建一个空的 GameObject，然后在其 Inspector 面板中点击 Add Component，并在 Scripts 中选择 OVR Passthrough Layer。

在场景中选择 Camera Rig 对象，修改 OVR Manager 选项：

修改 Quest Features > General > Passthrough Support，选择 Required 或 Supported，以启用构建时使用 Passthrough 所需的组件。
修改 Insight Passthrough & Guardian Boundary > Enable Passthrough，启用该选项，以在应用启动时初始化（也可以稍后通过 C# 脚本初始化） Passthrough。

alt text

然后使用 Project Setup Tool 更新配置，在 Meta (Android) 页面中点击 Fix All 和 Apply All。

alt text

最后，使用菜单 Meta > Tools > Android Manifest Tool 打开 Meta Android Manifest 工具，点击 Update AndroidManifest.xml for Store Compatibility，以更新 AndroidManifest.xml。如果配置已经正确，则该按钮会显示为灰色。

alt text