本指南詳細說明為 Android XR 開發 Unreal Engine 應用程式時,建議使用的引擎版本、必要 SDK 和 Android 專案設定。
必要條件
如要設定 Unreal Engine 進行 Android XR 開發,您必須先安裝下列應用程式和工具:
下載並安裝 Epic Games 啟動器。
- 從 Epic Games 啟動器安裝 Unreal Engine 5.6.1 以上版本。
設定系統來建構 C++ 程式碼 (例如使用 Windows 版 Visual Studio 2022,或 macOS 版 Xcode)。詳情請參閱 Epic 的 C++ 開發環境設定。
安裝 .NET 8.0 SDK。
安裝 Android Studio (Panda 4 | 2025.3.4 修補程式 1 以上版本)。
安裝 Android 建構支援
由於 Android XR 依賴特定 SDK 版本,因此您必須在 Unreal Engine 旁安裝正確的 Android 建構工具。
- 開啟 Epic Games 啟動器。
按一下已安裝的引擎版本 (「啟動」按鈕) 旁邊的下拉式箭頭,然後按一下「選項」。
- 捲動至安裝選項,選取「Android」,然後按一下「套用」。
- 如果系統提示,請允許引擎註冊所需的任何副檔名。
安裝 Java JDK 17。
在 Android Studio 中,使用 SDK Manager 安裝 Android XR 範例所需的特定版本:
- SDK 平台:34、35 和 36
- NDK:29.0.x
- 指令列工具 (所有項目)
請按照 Epic 的進階設定和疑難排解指南,設定下列系統環境變數:
ANDROID_HOMEJAVA_HOMENDK_ROOT
建立 Unreal XR 專案
接著,建立新專案,並使用必要的 XR 外掛程式和輸入內容進行設定:
- 啟動 Unreal Engine 5.6.1。
- 在「New Project Categories」(新專案類別) 下方,選取「Virtual Reality」(虛擬實境) 範本。
- 在「專案預設值」選單中,將「目標平台」設為「行動」。
- 將「品質預設」設為「可擴充」,以在行動裝置 XR 硬體上獲得最佳效能。
- 選擇專案名稱,然後按一下「建立」。
設定 Android 設定
開啟專案後,請完成下列步驟,為 Android XR 設定必要的 Android API 層級和圖像設定:
- 依序前往「Edit」>「Project Settings」。
- 依序前往「平台」>「Android」。
- 如果「接受 SDK 授權」按鈕以紅色醒目顯示,請點選該按鈕。
- 在「APKPackaging」(APK 封裝) 部分:
- 將「Minimum SDK Version」(最低 SDK 版本) 設為
34。 - 將「目標 SDK 版本」設為
34以上版本。
- 將「Minimum SDK Version」(最低 SDK 版本) 設為
進一步捲動至「建構」部分,然後選取「支援 Vulkan」。
Vulkan 是 Android XR 建議使用的高效能圖形 API。
設定算繪設定
如要達到 Android XR 要求的超高影格率和視覺清晰度,您也必須設定 Unreal Engine,使用最佳化的行動裝置算繪路徑:
- 依序前往「Edit」>「Project Settings」,然後前往「Engine」>「Rendering」。
在「Forward Renderer」(轉送算繪器) 部分下方,選取「Forward Shading」(轉送陰影)。
與預設的延遲轉譯器相比,前向轉譯器可大幅提升行動 VR 的速度。請注意,啟用這項功能需要重新啟動編輯器並編譯著色器。
在「預設設定」部分下方,將「反鋸齒方法」設為「MSAA」。
在「手機」專區下方,將「手機 MSAA」設為「4x」。
MSAA 可為 VR 提供最清晰的結果,不會產生因時間性反鋸齒 (TAA) 造成的模糊效果。
在「VR」部分下方:
清除「行動裝置 HDR」。
在行動裝置上停用高動態範圍,可大幅減少後續處理的負擔。
選取「行動裝置多重視角」。
這樣一來,引擎就能在單一通道中算繪雙眼,大幅提升 CPU 效能。
另請參閱
如需將範本專案部署至 Android 裝置的詳細操作說明,請參閱「設定 Unreal Engine 專案以進行 Android 開發」。