本指南詳細說明為 Android XR 開發 Unity 應用程式時,建議使用的編輯器版本、圖像設定、URP 設定和 Android 專案設定。
必要條件
如要使用 Unity 開發,請下載並安裝 Unity Hub。
安裝 Unity 編輯器和 Android 建構支援的6000.0.58f2 以上版本,包括:
- OpenJDK
- Android SDK
- Android NDK 工具
選取算繪引擎
建議使用 Vulkan Graphics API 轉譯 Android XR 應用程式。如要選取 Vulkan 做為圖像 API,請按照下列步驟操作:
- 在 Unity 中,依序前往「Edit」>「Project Settings」>「Player」。
- 選取「Android」分頁標籤,然後依序前往「Other Settings」>「Rendering」。
- 如果啟用「自動圖形 API」,請停用這項設定,即可顯示「圖形 API」部分。
在「Graphics APIs」(圖形 API) 部分,選取「Add」(新增) 按鈕,然後從下拉式選單中選取「Vulkan」。
使用控點 (=) 重新排序 Graphics API,讓 Vulkan 列在最前面。
視需要選取其他 Graphics API,然後按一下「移除」 (-) 按鈕移除。
Universal Render Pipeline
Android XR 支援通用算繪管線 (URP)。如果您打算使用透視功能,請更新預設 URP 設定,在 Android XR 上獲得最佳透視效能。
下表列出 Unity 建議的 URP 設定,後續章節會詳細說明。
設定 |
位置 |
建議值 |
---|---|---|
高動態範圍 |
通用算繪管道資產 |
已停用 |
後置處理 |
通用轉譯器資料 |
已停用 |
通用算繪管道資產設定
請按照下列步驟,針對 Android XR 最佳化通用渲染管線資產:
找出專案的通用算繪管道資產。其中一種方法是在「Project」視窗的搜尋列中輸入
t:UniversalRenderPipelineAsset
。在「畫質」標題下方,停用「HDR」。
通用 Renderer 資料設定
請按照下列步驟,針對 Android XR 最佳化通用算繪器資料:
找出專案的通用算繪器資料資產。其中一種方法是在「Project」視窗的搜尋列中輸入
t:UniversalRendererData
。在「檢查器」的「後續處理」標題下方,取消勾選「已啟用」。
最低 Android API 級別
將專案的最低 API 級別設為 24,這是 OpenXR Loader 的必要條件。否則建構作業可能會失敗。
請完成下列步驟,設定最低 Android API 級別。
- 依序前往「Edit」>「Project Settings」>「Player」。
- 選取「Android」分頁標籤,然後開啟「其他設定」。
- 在「Identification」(識別) 區段中,選取「Minimal API level」(最低 API 級別) 24 以上。
應用程式進入點
設定應用程式進入點的下列設定:
- 依序前往「Edit」>「Project Settings」>「Player」。
- 選取「Android」分頁,然後開啟「其他設定」。
- 在「Configuration」部分,確認「Application Entry Point」已勾選「GameActivity」,且未勾選「Activity」。
彈出式視窗
大多數 Android XR 應用程式都需要可調整大小的視窗,因為必須顯示系統權限要求等彈出式視窗。
請按照下列步驟操作,確保彈出式視窗正確顯示。
- 依序前往「Edit」>「Project Settings」>「Player」。
- 選取「Android」分頁標籤,然後開啟「Resolution and Presentation」
- 在「解析度」部分,啟用「可調整大小的活動」。
另請參閱
OpenXR™ 和 OpenXR 標誌是 The Khronos Group Inc. 的商標,已在中國、歐盟、日本和英國註冊為商標。