本指南詳細說明在開發 Android XR 專用的 Unity 應用程式時，建議使用的編輯器版本、圖形設定、URP 設定和 Android 專案設定。
必要條件
如要使用 Unity 進行開發，您必須下載並安裝 Unity Hub。
安裝 6000.0.23f1 以上版本的 Unity 編輯器和 Android Build Support，其中包括：
- OpenJDK
- Android SDK
- Android NDK 工具
選取轉譯引擎
建議您使用 Vulkan Graphics API 轉譯 Android XR 應用程式。如要選取 Vulkan 做為圖像 API，請按照下列步驟操作：
- 在 Unity 中，依序前往「Edit」 >「Project Settings」 >「Player」。
- 選取「Android」分頁標籤，然後依序前往「Other Settings」>「Rendering」。
- 如果已啟用 Auto Graphics API，請停用這項設定，即可顯示「Graphics APIs」部分。
在「Graphics APIs」部分，選取「Add (+)」按鈕，然後從下拉式選單中選取「Vulkan」。
使用句柄 (=) 重新排序圖形 API，讓 Vulkan 列為第一個。
您也可以選取其他 Graphics API，然後按一下「移除」 (-) 按鈕來移除。
Universal Render Pipeline
Android XR 與 Universal Render Pipeline (URP) 相容。如果您打算使用穿透功能，請更新預設的 URP 設定，以便在 Android XR 上獲得最佳穿透效能。
下表列出 Unity 建議的 URP 設定，後續章節會進一步說明。
設定 |
位置 |
建議值 |
|---|---|---|
高動態範圍 |
Universal Render Pipeline 素材資源 |
已停用 |
後置處理 |
通用轉譯器資料 |
已停用 |
通用算繪管道資產設定
請按照下列步驟，為 Android XR 最佳化通用算繪管道資產：
找出專案的 Universal Render Pipeline Asset。其中一種方法是在「Project」視窗的搜尋列中輸入
t:UniversalRenderPipelineAsset。在「品質」標題下方，停用「HDR」。
通用轉譯器資料設定
請按照下列步驟，為 Android XR 最佳化通用算繪器資料：
找出專案的通用轉譯器資料資產。其中一種方法是將
t:UniversalRendererData輸入「Project」視窗的搜尋列中。在「Inspector」中，取消勾選「Post-processing」標題下方的「Enabled」。
最低 Android API 級別
將專案設定為 OpenXR Loader 所需的最低 API 級別 24。否則建構作業可能會失敗。
請完成下列步驟，設定 Android API 級別的最低要求。
- 依序前往「編輯」 >「Project Settings」 >「Player」。
- 選取「Android」分頁，然後開啟「其他設定」。
- 在「Identification」部分，選取「Minimum API level」的 24 或更高版本。
應用程式進入點
為應用程式進入點設定下列設定：
- 依序前往「編輯」 >「Project Settings」 >「Player」。
- 選取「Android」分頁標籤，然後開啟「其他設定」。
- 在「Application Entry Point」專區中，確認已勾選「GameActivity」，且未勾選「Activity」。
彈出式視窗
大多數 Android XR 應用程式都需要可調整大小的視窗，因為系統權限要求等彈出式視窗都需要使用這類視窗。
請按照下列步驟操作，確保彈出式視窗正確顯示。
- 依序前往「編輯」 >「Project Settings」 >「Player」。
- 選取「Android」分頁標籤，然後啟用「可調整大小的活動」。