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