Unreal Engine 项目设置

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

前提条件

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

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 Patch 1 或更高版本）。

安装 Android build 支持

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

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. 在 Project Defaults 菜单中，将 Target Platform 设置为 Mobile 。
4. 将 Quality Preset 设置为 Scalable ，以在移动 XR 硬件上实现最佳性能。
5. 选择项目名称，然后点击创建 。

配置 Android 设置

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

1. 依次前往编辑 > 项目设置 。
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. 依次前往编辑 > 项目设置 ，然后依次前往 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. 选择 Mobile 多视图 。

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

另请参阅

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