設定 Unreal Engine 專案

適用的 XR 裝置
本指南可協助您為這類 XR 裝置打造體驗。
瞭解 XR 裝置類型 →
XR 頭戴式裝置
有線 XR 眼鏡
瞭解 XR 裝置類型 →

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

必要條件

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

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

    1. 在 Epic Games 啟動器中，安裝 Unreal Engine 5.6.x 或 5.8.x 版。

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

  3. 安裝 .NET 8.0 SDK。

  4. 安裝 Android Studio (Rabbit 2 | 2026.2.2 以上版本)。

安裝 Android 建構支援

Android XR 仰賴特定 SDK 版本，因此您必須安裝正確的 Android 建構工具和 Unreal Engine。

  1. 開啟 Epic Games 啟動器。

  2. 按一下已安裝引擎版本 (「Launch」按鈕) 旁的下拉式箭頭，然後按一下「Options」。

    1. 進一步捲動至安裝選項，選取「Android」，然後按一下「Apply」。
    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.x 或 5.8.x 版)。
  2. 在「New Project Categories」下方，選取「虛擬實境」範本。
  3. 在「Project Defaults」選單中，將「Target Platform」設為「Mobile」。
  4. 將「Quality Preset」設為「Scalable」，在行動 XR 硬體上達到最佳效能。
  5. 選擇專案名稱，然後按一下「建立」。

調整 Android 設定

開啟專案後，請完成下列步驟，設定 Android XR 所需的 Android API 級別和圖形設定：

  1. 依序前往「Edit」>「Project Settings」。
  2. 依序前往「Platforms」>「Android」。
  3. 如果「Accept SDK License」按鈕醒目顯示為紅色，請按一下該按鈕。
  4. 在「APKPackaging」部分：
    • 將「Minimum SDK Version」設為 34。
    • 將「Target SDK Version」設為 34 (或以上版本)。

  5. 向下捲動至「Build」部分，然後選取「Support Vulkan」。

    Vulkan 是 Android XR 推薦的高效能圖形 API。

調整算繪設定

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

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

  2. 在「Forward Renderer」部分下方，選取「Forward Shading」。

    與預設的延遲轉譯器相比，正向轉譯器在行動 VR 上的速度明顯更快。請注意，啟用這項功能需要重新啟動編輯器和著色器編譯。

  3. 在「Default Settings」部分，將「Anti-Aliasing Method」設為「MSAA」。

  4. 在「Mobile」部分，將「Mobile MSAA」設為「4x」。

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

  5. 在「VR」部分：

    1. 清除「Mobile HDR」。

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

    2. 選取「行動裝置多格觀看」。

      這樣一來，引擎就能一次算繪雙眼，大幅提升 CPU 效能。

另請參閱

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