使用虚幻引擎开发 MetaQuest

入门指南的这一部分将引导您创建、打包和部署第一个适用于 Meta Quest 的虚幻引擎应用程序。

安装 Android Studio 和 Android NDK

您必须下载并安装 Android Studio 和 Android NDK。这将为虚幻引擎提供运行所需的一些依赖项，例如 Apache Ant 和 Java 开发工具包 (JDK)。

要安装 Android Studio 和 NDK，请按照虚幻引擎文档中的“设置 Android SDK 和 NDK ”中的说明进行操作。

从源代码构建或下载适用于 UE5 的 MetaXR 插件

ps：对于萌新直接通过虚幻启动器，下载4.27.x版本的虚幻引擎即可，可省略该步骤直接跳到下面的“创建您的项目”。

您需要一个专为 Meta Quest 开发而定制的虚幻引擎版本。您有两个选择：

下载UE5的MetaXR插件并将其复制到Epic提供的虚幻引擎5中。
从 GitHub 获取 UE5 或 UE4 的 Oculus-VR 分支，然后自行编译虚幻引擎的定制版本。

选项 1：下载 MetaXR 插件并将其复制到虚幻引擎 5

要将 Epic 的 Meta Quest 支持添加到 UE5：

根据虚幻引擎5文档中的“安装虚幻引擎”下载并安装UE5。
从虚幻引擎 5 集成下载页面下载适用于 UE5 的 MetaXR 插件 .zip 文件。
将 .zip 文件内容提取到ue5InstallationFolder\Engine\Plugins\Marketplace\MetaXR`。例如：C:\Program Files\Epic Games\UE_5.0\Engine\Plugins\Marketplace\MetaXR

选项2：获取虚幻引擎的Oculus-VR Fork并从源代码编译

按照GitHub 上访问虚幻引擎源代码的说明获取：

一个史诗帐户
一个 GitHub 帐户
访问虚幻引擎源代码存储库的授权

请忽略有关下载 Epic 虚幻引擎源代码的说明，因为您将构建虚幻引擎源代码的 Oculus-VR 分支。

从 GitHub 上虚幻引擎的 Oculus-VR分支下载源代码，并将其解压到您的开发计算机上的某个位置。为了避免构建时出现潜在错误，请注意文件路径长度。

重要的

提取或克隆源代码。请注意，超过Windows 最大路径长度的路径将导致构建失败。如果这是一个问题，请不要映射到网络共享。这将大大减慢构建过程。相反，为该目录创建一个连接点。

启动 Visual Studio 安装程序，然后针对要使用的 Visual Studio 版本单击“修改” 。
在“工作负载”选项卡下，单击“使用 C++ 进行游戏开发”（如果未选中），然后单击“修改”。
要完成该过程，请按照 Epic 关于从源代码构建虚幻引擎的说明进行操作。

根据您的机器，构建可能需要一段时间才能完成。

创建您的项目

在本节中，您将使用虚幻引擎创建一个项目：

在虚幻引擎启动器中，按启动按钮打开虚幻项目浏览器。
从虚幻项目浏览器的“游戏”部分，选择“空白”。
对于项目默认值，选择：
- 蓝图
- 移动的
- 可扩展
- 无入门内容
在屏幕底部：
- 设置文件夹位置
- 设置项目名称
您的屏幕应如下所示：
按“创建”按钮创建项目并加载空白项目。

配置 Meta Quest 开发项目

官方视频：为Oculus头显设备开发UE4项目

在本部分中，您将启用 MetaXR 或 Oculus VR 插件并修改一些项目设置以与 Meta Quest 设备配合使用。

转到“编辑” > “插件”，然后选择“虚拟现实”部分。
启用Meta XR插件（ UE4 上的Oculus VR）。在 UE5 上避免使用 Oculus VR（已弃用）。如果您没有看到Meta XR，请下载Meta XR 插件。
要在将任何虚幻引擎项目部署到头盔后运行该项目，您必须至少保存一个虚幻引擎关卡。要保存当前关卡，请按工具栏中的“保存”图标进行保存。为其命名，例如QuestQSMap。
选择编辑 > 项目设置。然后，在“项目”下，选择“地图和模式”部分：
在Default Maps下，将Editor Startup Map和Game Default Map设置为您刚刚保存的关卡：
向下滚动并选择引擎 > 输入。找到移动部分：
对于“默认触摸界面”，选择“清除”，从而将该值设置为“无”：

结果应该是这样的：
向下滚动到平台部分，选择Android。然后在右侧向下滚动到APK 打包部分，如有必要，请单击立即配置：
根据您的目标设备进行以下设置。

对于 Meta Quest 2 和 Meta Quest Pro：
- 最低 SDK 版本：29
- 目标 SDK 版本：29
- 在 KitKat 及以上设备上启用全屏沉浸式，检查 True
在构建中禁用支持 OpenGL ES3.2（官方虚幻引擎为OpenGL ES3.1），勾选支持Vulkan。
打开Advanced APKPackaging并单击Oculus Mobile 设备包旁边的+。从下拉列表中选择Oculus Quest 2（如果有Quest1可多加一个Quest1）。注意：对于 Quest Pro 支持，请选择插件，然后选择MetaXR，并在移动下添加Quest Pro。您仍必须在上述步骤中选择任务 2。
单击Android SDK部分，并确保构建项目所需的 Android SDK 工具指向计算机上的正确文件夹，并且您已为每个设备设置了 API 级别。
滚动到“引擎”部分，选择“渲染”，然后在“移动”和“移动 MSAA”下，确保选择“ 4x MSAA” 。
进一步滚动到渲染设置的VR部分，并确保移动 HDR已关闭。下图显示了一个示例。
在渲染的VR部分启用Mobile Multi-view。

请注意，您可能需要重新启动项目才能应用其中一些设置。
将您选择的其他代码添加到项目中。

请注意，本主题中描述的许多设置也在Oculus 性能窗口中提供。有关更多信息，请参阅Oculus 性能设置。

添加权利检查

建议 Meta Quest Store 上发布的所有虚幻应用程序实施权利检查，以验证用户的应用程序是否合法。有关如何实施权利检查的信息，请参阅平台解决方案指南中的《虚幻开发入门》。

在头盔上启动您的应用程序

本节介绍如何启动虚幻引擎项目以便可以在头盔中查看它。

下载最新 Oculus ADB驱动程序，并安装。
确保您的头盔已通过 USB 电缆连接到开发 PC。
确保您已安装并可以运行 Android 调试桥 (ADB)，并且您的 PC 可以使用 ADB 命令 adb devices 查看设备。有关更多信息，请参阅《移动 SDK 开发人员指南》中的使用ADB与MetaQuest连接
在虚幻引擎编辑器中，单击“启动”图标旁边的来打开“在设备上启动的选项”：
从下拉列表中，选择要部署到的设备。如果系统提示您保存项目，即使您最近保存过，也请务必执行此操作。这将确保最新内容驻留在您的头盔上。
在虚幻引擎编辑器的下角，有一个进度条指示打包过程的状态。如果这是您第一次打包项目，则可能需要几分钟，具体取决于项目的大小。
该过程完成后，您应该能够启动该项目并在头盔中查看它。

插件设置

配置应用程序的不同方面，例如是否支持手部跟踪、使用什么级别的 FFR，以及使用插件设置设置色彩空间。有关更多信息，请参阅插件设置。

应用程序分发

当您准备好分发应用程序时，需要使用 Android 分发密钥库才能提交到 Meta Quest 商店。

在构建最终发布包之前，请创建一个新的 Android 密钥库，如 Android 的应用程序签名指南中的“手动签署 APK”部分所述。生成分发密钥库后，在虚幻编辑器中，转到Edit > Project Settings > Platforms > Android，向下滚动到Distribution Signing，然后输入所需信息。

有关详细信息，请参阅Mobile SDK 文档的应用程序签名部分。

注意：查看Distribute非常重要，其中涵盖 Meta Quest Store 提交要求和指南。

打包您的应用程序

Meta Quest：编译和打包应用程序 本节提供有关运行和部署面向 Meta Quest 的 Unreal 应用程序的深入信息。