Unreal Engine 项目设置

适用的 XR 设备
本指南可帮助您为以下类型的 XR 设备打造优质体验。
了解 XR 设备类型 →
扩展现实头戴设备
有线扩展现实眼镜
了解 XR 设备类型 →

本指南详细介绍了为 Android XR 开发 Unreal Engine 应用时推荐的引擎版本、必需的 SDK 和 Android 项目设置。

前提条件

在设置 Unreal Engine 以进行 Android XR 开发之前，您需要安装以下应用和工具：

  1. 下载并安装 Epic Games Launcher。

    1. 从 Epic Games Launcher 安装 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 补丁 1 或更高版本）。

安装 Android build 支持

由于 Android XR 依赖于特定的 SDK 版本，因此您必须在安装 Unreal Engine 的同时安装正确的 Android 构建工具。

  1. 打开 Epic Games 启动器。

  2. 点击已安装的引擎版本（“启动”按钮）旁边的下拉箭头，然后点击选项。

    1. 继续向下滚动到安装选项，选择 Android，然后点击应用。
    2. 如果系统提示，请允许引擎注册其所需的任何文件扩展名。

  3. 安装 Java JDK 17。

  4. 在 Android Studio 中，使用 SDK 管理器安装 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. 将质量预设设置为可伸缩，以在移动 XR 硬件上实现最佳性能。
  5. 选择项目名称，然后点击创建。

配置 Android 设置

打开项目后，请完成以下步骤，为 Android XR 设置所需的 Android API 级别和图形设置：

  1. 依次前往 Edit > Project Settings。
  2. 前往 Platforms > Android。
  3. 如果 Accept SDK License 按钮突出显示为红色，请点击该按钮。
  4. 在 APKPackaging 部分中：
    • 将 Minimum SDK Version 设置为 34。
    • 将目标 SDK 版本设置为 34（或更高版本）。

  5. 进一步向下滚动到构建部分，然后选择支持 Vulkan。

    Vulkan 是 Android XR 推荐的高性能图形 API。

配置渲染设置

为了实现 Android XR 所需的高帧速率和视觉清晰度，您还必须将虚幻引擎配置为使用经过优化的移动渲染路径：

  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 开发。