Unreal Engine 项目设置

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

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

前提条件

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

  1. 下载并安装 Epic Games 启动器。

    1. 在 Epic Games 启动器中，安装 Unreal Engine 的 5.6.1 版（或更高版本）。

  2. 设置系统以构建 C++ 代码（例如，使用 Visual Studio 2022（适用于 Windows）或 Xcode（适用于 macOS））。如需了解详情，请参阅 Epic 的 C++ 开发环境设置。

  3. 安装 .NET 8.0 SDK。

  4. 安装 Android Studio（Quail 2 | 2026.1.2 或更高版本）。

安装 Android build 支持

由于 Android XR 依赖于特定 SDK 版本，因此您必须在 Unreal Engine 旁边安装正确的 Android build tools。

  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.1。
  2. 在新项目类别下，选择虚拟现实模板。
  3. 在项目默认设置菜单中，将目标平台设置为移动设备。
  4. 将质量预设设置为可伸缩，以在移动 XR 硬件上实现最佳性能。
  5. 选择项目名称，然后点击创建。

配置 Android 设置

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

  1. 依次前往“编辑”>“项目设置”。
  2. 前往平台 > Android。
  3. 如果接受 SDK 许可按钮突出显示为红色，请点击该按钮。
  4. 在 APKPackaging 部分中：
    • 将最低 SDK 版本 设置为 34。
    • 将目标 SDK 版本设置为 34（或更高版本）。

  5. 进一步滚动到 Build 部分，然后选择 Support Vulkan。

    Vulkan 是建议使用的 Android XR 高性能图形 API。

配置渲染设置

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

  1. 依次前往编辑 > 项目设置，然后前往引擎 > 渲染。

  2. 在 Forward Renderer 部分下，选择 Forward Shading。

    对于移动 VR，前向渲染器的速度明显快于默认的延迟渲染器。请注意，启用此功能需要重启编辑器并编译着色器。

  3. 在默认设置部分下，将抗锯齿方法设置为 MSAA。

  4. 在移动设备部分下，将移动设备 MSAA 设置为 4 倍。

    MSAA 可为 VR 提供最清晰的效果，而不会产生时间抗锯齿 (TAA) 造成的模糊效果。

  5. 在 VR 部分下：

    1. 清除 Mobile HDR。

      在移动设备上停用高动态范围 (HDR) 可大幅减少后处理开销。

    2. 选择移动多视图。

      这样一来，引擎就可以在一次渲染中同时渲染双眼，从而显著提升 CPU 性能。

另请参阅

如需详细了解如何将模板项目部署到 Android 设备，请参阅为 Android 开发设置 Unreal Engine 项目。