在 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 的位置，也可以在程式碼中修改。