在 EasyAR 項目中啓用頭顯支持
本文檔介紹瞭如何在一個已有的 EasyAR Unity 場景中啓用頭顯支持。
開始之前
- 閱讀 EasyAR 的頭顯支持 瞭解 EasyAR 已經支持的頭顯類型和頭顯上可以運行的 EasyAR 功能。
- 閱讀 Unity 中的 EasyAR 頭顯支持 瞭解在 Unity 中 EasyAR 頭顯支持的整體架構。
本文假設您有一個已經可以使用 EasyAR 的場景。如果需要創建這樣的場景，或是在一個頭顯場景中添加 EasyAR 組件，可以參考以下文檔：
在場景中添加頭顯組件
在場景中添加頭顯組件之前，通常需要移除現有的 Camera 和 XR Origin。
移除 Camera 和 XR Origin
刪除場景中現有的 Camera。
如果場景裏已經存在 XR Origin，無論它來自 EasyAR 還是 Unity XR 框架，大部分情況下需要將其刪除。
提示
在一些高級的用法中，可以根據自己需要判斷是否刪除。
添加頭顯組件
遵循頭顯官方說明來添加頭顯的組件。這裏以 Pico 頭顯爲例，與官方說明衝突時以官方說明爲準。
使用菜單添加一個 XR Interaction Manager：
使用菜單添加一個 XR Origin：
在運行之前，需要確保閱讀頭顯官方說明來了解一個有頭顯 SDK 的場景應該如何進行配置和運行。
配置 frame source
內置支持的設備
選中 AR Session (EasyAR) 並點擊右鍵，通過菜單 EasyAR Sense > Head Mounted Display (Built-in) > Frame Source : [Name] (keep it only) 創建 [Name] 的 frame source 並僅保留它。
比如，爲 Apple Vision Pro 配置 frame source：
操作之後 session 中的 frame source 會變成這樣：
提示
如果 session 中包含設備對應的 frame srouce 並且在設備上是第一個可用的 frame source（比如上圖中，在 visionOS 系統中 VisionOS ARKit 就是第一個可用的 frame source），可以不修改。部分菜單創建的默認 session 就屬於這種情況。
擴展支持的設備
選中 AR Session (EasyAR) 並點擊右鍵，通過菜單 EasyAR Sense > Extensions > Frame Source : [Name] (keep it only) 創建 [Name] 的 frame source 並僅保留它。
比如，爲 Pico 頭顯配置 frame source：
操作之後 session 中的 frame source 會變成這樣：
跨設備支持
如果需要場景可以在不同設備上運行，需要保留其它 frame source，並確保在設備當前 frame source 可以被選中。
使用不含 (keep it only) 的菜單項可以只添加 frame source 且不刪除其它 frame source，比如 EasyAR Sense > Extensions > Frame Source : Pico 將在 session 所有 frame source 最後創建適用於 Pico 的 frame source。一般來說，通過這個方式添加完 frame source 之後，還需要將它移動到合適的位置。
提示
在一些高級的用法中，可以根據自己需要調整 frame source 的位置，也可以在代碼中修改。