开发

利用 Unreal Engine 进行平台开发设置

更新时间: 2026年4月17日

本指南将向您详细讲解如何设置 Unreal Engine (UE) 开发环境和检查用户的权利。

与其他环境不同，Unreal 平台 SDK 支持 Blueprint 和原生 C++ API。

创建应用

在集成平台 SDK 之前，如果尚未创建应用，您需要在开发者面板中创建一个应用。请参阅创建和管理应用页面来创建应用。

配置开发环境

请查看 Unreal Engine 指南中的 Meta Quest UE 版开发入门。当您能够自如地使用 UE 开发 Meta Quest 应用后，即可实现 Meta Horizon 平台功能。

注意：Meta Horizon 操作系统平台功能已被直接集成到 Unreal Editor 中。如要查看您的 Unreal Engine 版本中包含哪一平台版本，请参见版本兼容性。如要使用最新版本的平台，您可以单独下载。

安装平台 SDK 插件

根据您使用的 Unreal Engine 版本选择安装平台 SDK 的方法。

使用 Unreal Engine 5 的 Epic Launcher 版本

按照 UE5 文档中安装 Unreal Engine⁠ 页面上的说明下载并安装 UE5。

下载 Platform SDK plugin for UE5 .zip 文件。

将 .zip 文件内容解压到以下 UE5 安装文件夹：\Engine\Plugins\Marketplace\MetaXRPlatform。例如：C:\Program Files\Epic Games\UE_5.3\Engine\Plugins\Marketplace\MetaXRPlatform。

注意：以上说明适用于 Unreal Engine 5。有关旧版 Unreal Engine 4 的说明，请参阅旧版：Unreal Engine 4 安装。

使用 GitHub 分叉版本

安装 Unreal Engine 的 GitHub Meta 分叉版本，其中包含 UE5 的平台 SDK。

启用平台 SDK 插件

在编辑器中，选择编辑 > 插件 > 在线平台 > Meta XR 平台，然后选中启用。编辑器会提示您重新启动 Unreal Editor。

调整您的 DefaultEngine.ini 文件以使用 Meta Quest：

如果您的项目中没有 DefaultEngine.ini 文件，请在 [ProjectDirectory]/Config/ 下创建一个。

[OnlineSubsystemOculus]
bEnabled=true
MobileAppId=[quest_app_id_here]
RiftAppId=[rift_app_id_here]

MobileAppId 是 Meta Quest 应用的唯一应用编号，可从 Meta Horizon 开发者面板的 API 页面⁠获取。

RiftAppId 是用于在 PC 上使用 Meta Quest Link 测试应用的应用编号。此编号与 MobileAppId 不同。

如果启用 Meta XR 平台插件，您的应用将需要访问用户编号和用户主页，并且在提交应用至 Meta Horizon 商店的过程中，应用需要接受数据使用情况检查。如需了解详情，请参阅完成数据使用情况检查。

为本地开发配置应用

本部分中的配置步骤让开发者可在开发过程中运行应用程序的本地编译版本。这个流程是必需的，否则应用的本地版本将无法通过您将在以下步骤中集成的权利检查。

将用户添加到您的团队。如需了解有关管理团队的信息，请参阅管理团队和用户。

如果某些开发者不属于应用程序的团队，而他们又需要在正常安装目录之外运行应用程序，请将注册表键 AllowDevSideloaded 作为 DWORD(1) 添加到位于 HKLM\SOFTWARE\Wow6432Node\Oculus\Oculus 的注册表文件夹中。这并不能绕过有效权利验证，而只是绕过目录检查。

完成上述步骤后，当运行应用程序的本地编译版本时，权利检查便会成功执行。

使用 Meta XR 平台 SDK

1.创建 GameInstance

您的项目可能业已设好一个自定义 GameInstance 来支持应用程序。如果没有，则必须添加实例并确保项目使用它。在项目设置的地图和模式部分，点击 + 号创建一个新 Blueprint。

在“项目设置”>“地图和模式”>“游戏实例”中创建新的游戏实例类，并将其分配给项目

完成后，将出现空白的 Blueprint 编辑器。

2.启动系统

您必须启用 Meta XR 平台来处理消息和生成事件。子系统运行后，您只能调用平台节点。

初始化平台子系统会引发一个事件，指示进程成功还是失败。如要响应此事件，请在 GameInstance Blueprint 中创建名为 OvrPlatformSubsystemStarted 的自定义事件，并将执行引脚附加到节点，以处理子系统初始化的成功或失败。自定义事件名称必须与 OvrPlatformSubsystemStarted 完全一致，且位于 GameInstance Blueprint 中。