设置 Unreal 项目

建议安装 Unreal Engine 4.27 或 5.0,以充分利用内置的 HoloLens 支持。

转到 Epic Games Launcher 的“库”选项卡,选择“启动”旁的下拉箭头,然后单击“选项”。 在“目标平台”下,选择“HoloLens 2”,然后单击“应用”Unreal Install Option HoloLens 2

导入 Unreal 的混合现实工具包

MRTK

混合现实工具包 (MRTK) 是一个用于混合现实应用程序的开源跨平台开发工具包。 MRTK 提供跨平台的输入系统、基础组件以及用于空间交互的通用构建基块。 该工具包旨在加快面向 Microsoft HoloLens、Windows Mixed Reality 沉浸式 (VR) 头戴显示设备和 OpenVR 平台的应用程序的开发。

如果还没有混合现实项目,请按照 HoloLens 2 入门教程的前 3 个部分准备好项目供 MRTK 使用。

适用于 Unreal 的 MRTK 中心简介

建议使用 MRTK 中心获取 MRTK 插件。 这是开发人员发现和更新 Microsoft Mixed Reality 插件并将其添加到 Unreal 项目的一种新方式。 无需退出 Unreal 编辑器,即可查看插件、了解其依赖项并将其安装到你的项目中。

  • 发现新的 Microsoft Mixed Reality 插件,并将其依赖项安装到你的 Unreal 项目中。
  • 将 Microsoft Mixed Reality 插件保持在最新状态。
  • 如果不再需要 Microsoft Mixed Reality 插件,请将其从项目中删除。

注意

适用于 Unreal 的 MRTK 中心仅可用于 Unreal Engine 4.26 及更高版本。 对于 Unreal Engine 4.25+,可从 Unreal Engine 市场或 GitHub 获取 MRTK 插件,如入门部分所述。

安装 MRTK 中心

Unreal Engine 市场下载插件,打开你的项目,然后从“插件”菜单的“混合现实”部分启用插件。 出现提示时,重启编辑器。

Enable the MRTK Hub plugin

为项目启用插件后,可通过工具栏按钮访问中心。

Open the MRTK Hub window

安装混合现实插件

若要使用中心安装插件,请选择要添加到项目的插件,然后按“安装”按钮。 若要下载插件,请验证“问题”框中是否没有冲突,然后按“确认”。 下载插件后,系统会提示你重启编辑器。

Install a plugin using the MRTK Hub

编辑器重启后,可以继续混合现实开发历程

重要

安装插件后,必须将它签入到源代码管理,例如任何其他项目级别的插件。

更新混合现实插件

若要使用中心更新插件,请从列表中选择要更新的插件,然后按“安装”按钮。 若要下载更新后的插件,请验证“问题”框中是否没有冲突,然后按“确认”。 系统将提示你重启编辑器来完成更新。 请注意,由于要更新插件,重启可能需要一些时间。

Updating a plugin through the MRTK Hub

删除混合现实插件

若要使用中心卸载插件,请选择要删除的插件,然后从下拉列表中选择已安装的版本。 若要删除插件,请验证“问题”框中是否没有冲突,然后按“确认”。 系统将提示你重启编辑器来完成删除。 请注意,由于要删除插件,重启可能需要一些时间。

Removing a plugin through the MRTK Hub

查看更改并检测不兼容的情况

可在中心窗口底部查看将对项目进行的确切更改。 在这里,可看到将在项目中添加或删除的插件,以及进行更改时可能导致问题的任何潜在不兼容性。

注意

问题列表将在 Unreal 引擎版本和插件依赖项版本中显示不兼容,但它不会自动修复问题,也不会自动提出问题修复建议

Attempting to install an incompatible plugin

注意

如果你不想使用 Unreal 的 MRTK,则需要自行编写所有交互和行为的脚本。