設定 Unreal Engine 專案

本指南詳細說明為 Android XR 開發 Unreal Engine 應用程式時，建議使用的引擎版本、必要 SDK 和 Android 專案設定。

必要條件

如要設定 Unreal Engine 進行 Android XR 開發，您必須先安裝下列應用程式和工具：

1. 下載並安裝 Epic Games 啟動器。

   1. 從 Epic Games 啟動器安裝 Unreal Engine 5.6.1 以上版本。

2. 設定系統來建構 C++ 程式碼 (例如使用 Windows 版 Visual Studio 2022，或 macOS 版 Xcode)。詳情請參閱 Epic 的 C++ 開發環境設定。

3. 安裝 .NET 8.0 SDK。

4. 安裝 Android Studio (Panda 4 | 2025.3.4 修補程式 1 以上版本)。

安裝 Android 建構支援

由於 Android XR 依賴特定 SDK 版本，因此您必須在 Unreal Engine 旁安裝正確的 Android 建構工具。

1. 開啟 Epic Games 啟動器。

2. 按一下已安裝的引擎版本 (「啟動」按鈕) 旁邊的下拉式箭頭，然後按一下「選項」。

   1. 捲動至安裝選項，選取「Android」，然後按一下「套用」。
   2. 如果系統提示，請允許引擎註冊所需的任何副檔名。

3. 安裝 Java JDK 17。

4. 在 Android Studio 中，使用 SDK Manager 安裝 Android XR 範例所需的特定版本：

   • SDK 平台：34、35 和 36
   • NDK：29.0.x
   • 指令列工具 (所有項目)

5. 請按照 Epic 的進階設定和疑難排解指南，設定下列系統環境變數：

   • ANDROID_HOME
   • JAVA_HOME
   • NDK_ROOT

建立 Unreal XR 專案

接著，建立新專案，並使用必要的 XR 外掛程式和輸入內容進行設定：

1. 啟動 Unreal Engine 5.6.1。
2. 在「New Project Categories」(新專案類別) 下方，選取「Virtual Reality」(虛擬實境) 範本。
3. 在「專案預設值」選單中，將「目標平台」設為「行動」。
4. 將「品質預設」設為「可擴充」，以在行動裝置 XR 硬體上獲得最佳效能。
5. 選擇專案名稱，然後按一下「建立」。

設定 Android 設定

開啟專案後，請完成下列步驟，為 Android XR 設定必要的 Android API 層級和圖像設定：

1. 依序前往「Edit」>「Project Settings」。
2. 依序前往「平台」>「Android」。
3. 如果「接受 SDK 授權」按鈕以紅色醒目顯示，請點選該按鈕。
4. 在「APKPackaging」(APK 封裝) 部分：
   • 將「Minimum SDK Version」(最低 SDK 版本) 設為 34。
   • 將「目標 SDK 版本」設為 34 以上版本。

5. 進一步捲動至「建構」部分，然後選取「支援 Vulkan」。

   Vulkan 是 Android XR 建議使用的高效能圖形 API。

設定算繪設定

如要達到 Android XR 要求的超高影格率和視覺清晰度，您也必須設定 Unreal Engine，使用最佳化的行動裝置算繪路徑：

1. 依序前往「Edit」>「Project Settings」，然後前往「Engine」>「Rendering」。

2. 在「Forward Renderer」(轉送算繪器) 部分下方，選取「Forward Shading」(轉送陰影)。

   與預設的延遲轉譯器相比，前向轉譯器可大幅提升行動 VR 的速度。請注意，啟用這項功能需要重新啟動編輯器並編譯著色器。

3. 在「預設設定」部分下方，將「反鋸齒方法」設為「MSAA」。

4. 在「手機」專區下方，將「手機 MSAA」設為「4x」。

   MSAA 可為 VR 提供最清晰的結果，不會產生因時間性反鋸齒 (TAA) 造成的模糊效果。

5. 在「VR」部分下方：

   1. 清除「行動裝置 HDR」。

      在行動裝置上停用高動態範圍，可大幅減少後續處理的負擔。

   2. 選取「行動裝置多重視角」。

      這樣一來，引擎就能在單一通道中算繪雙眼，大幅提升 CPU 效能。

另請參閱

如需將範本專案部署至 Android 裝置的詳細操作說明，請參閱「設定 Unreal Engine 專案以進行 Android 開發」。