小马的世界

如何配置HoloLens2 MRTK3开发环境(Unity)

2022-12-06 · 3 min read

快速告诉你如何搭建HoloLens2 MRTK3开发环境。

这篇文章介绍MRTK3的配置,如果需要了解MRTK2的配置,请点击这里

新建项目

打开Unity Hub点击New Project,选择合适的编辑器版本,选择3D,输入项目名称、选择靠近根目录的路径。

添加项目运行时的Feature

  1. 下载Mixed Reality Feature Tool
  2. 下载完成后,解压缩文件并将其保存到桌面。
  3. 运行MixedRealityFeatureTool.exe
  4. 点击Start
  5. 选择你新建的Unity工程路径(该工具中的“项目路径”框必须包含某个值,因此默认情况下会插入一个反斜杠(“_”))
  6. 软件会检测到Unity版本。
  7. 点击Discover Features(可能需要等待几秒)
  8. 勾选MRTK3下的所有项目
  9. 勾选Platform Support下的Mixed Reality OpenXR Plugin
  10. 勾选Spatial Audio下的所有项目
  11. 点击Get Features

打开Unity项目

打开Unity项目,等待Unity完成导入新添加的包。过程中可能有以下窗口:

  1. Warning: Do you want to enable the backends? Doing so will *RESTART* the editor. 选择Yes
  2. XR InteractionLayerMask Update Required: 选择:No Thanks

Unity有可能在这个过程中重启几次,请耐心等待。

导入配置文件

导入包后,需要为目标平台设置配置文件

  1. 选择菜单栏的Edit->Project Settings...

  2. 在左侧选择MRTK3

  3. 点击右侧的Windows标徽(Universal Windows Platform settings)此时Profile显示为None

  4. 在Project面板左侧找到MRTK Core Definitions->Configuration->Default Profiles

  5. 将右侧的MRTKProfile拖入Project Settings窗口的Profile

  6. 点击Windows标徽(Universal Windows Platform settings)和显示器徽标(Windows, Mac, Linux settings),确认二者都已经有了配置文件。

配置OpenXR

  1. 选择菜单栏的Edit->Project Settings...
  2. 在左侧选择XR Plug-in Management
  3. 在Windows标徽(Universal Windows Platform settings)和显示器徽标(Windows, Mac, Linux settings)处确认勾选Initialize XR on StratupOpenXRMicrosoft HoloLens feature group。如果OpenXR旁边有黄色感叹号,点击黄色感叹号,点Fix all。会有一些无法修复的感叹号, 没关系,我们会在后面解决。
  4. 左侧点击XR Plug-in Management->OpenXR,在Windows标徽(Universal Windows Platform settings)和显示器徽标(Windows, Mac, Linux settings)下的Interaction Profile中,点击加号分别添加Eye Gaze Interaction Profile,Microsoft Hand Interaction Profile,Microsoft Motion Controller Profile,如果遇到黄色感叹号,点击黄色感叹号,点击Fix all。
  5. (可选)将Windows标徽(Universal Windows Platform settings)和显示器徽标(Windows, Mac, Linux settings)下的Depth Submission Mode修改为Depth 16 Bit

创建场景

  1. 在Project面板中Packages->MRTK Input->Assets->Prefabs中,将MRTK XR Rigprefab拖入窗口。
  2. 删除原有的Main Camera,因为MRTK XR Rig中已经包含摄像机。
  3. (可选,但如果你想在编辑内模拟运行推荐添加)在Project面板中Packages->MRTK Input->Simulation->Prefabs中,将MRTKInputSimulatorprefab拖入窗口。

这样就完成了HoloLens2 MRTK3的配置。