小马的世界

如何配置HoloLens2 MRTK2开发环境（Unity）

2022-12-06 · 5 min read

快速配置HoloLens2 MRTK2开发环境

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

准备

  • 配置了正确工具的 Windows 10 电脑
  • Windows 10 SDK 10.0.18362.0 或更高版本
  • 安装了 2020.3.x/2019.4.x 的 Unity Hub
  • 混合现实功能工具
  • 基本熟悉 Unity：界面、场景创建、包导入和向场景添加 GameObject

新建项目

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

在 Windows 上创建项目时，MAX_PATH 限制为 255 个字符。 Unity 受到这些限制的影响；如果任何文件路径的长度超过 255 个字符，就可能无法编译。 因此，建议将 Unity 项目存储在尽可能靠近驱动器根目录的位置。

生成设置

如果你找不到下面设置中的某一项，请检查你的版本Unity编辑器版本是否过高或过低（本文档基于Unity2020.3）

  1. 在菜单栏点击File->Build Settings

  2. 左侧选择Universal Windows Platform

  3. 右侧按如下配置：

    Target Device: HoloLens

    Architecture: ARM64

    Build Type: D3D Project

    Target SDK Version: Lasted installed

    Minimum Platform Version: 10.0.10240.0

    Visual Studio Version: Visual Studio 2019

    Build and Run on: Local Machine

    Build configuration: Release（Debug 有已知的性能问题，所以不推荐）

  4. 点击Switch Platform

添加项目运行时的Feature

  1. 下载Mixed Reality Feature Tool

  2. 下载完成后，解压缩文件并将其保存到桌面。

  3. 关闭运行中的Unity

  4. 运行MixedRealityFeatureTool.exe

  5. 点击Start

  6. 选择你新建的Unity工程路径（该工具中的“项目路径”框必须包含某个值，因此默认情况下会插入一个反斜杠（“_”））

  7. 软件会检测到Unity版本。

  8. 点击Discover Features（可能需要等待几秒）

  9. 勾选Mixed Reality Toolkit下的Mixed Reality Toolkit Examples, Mixed Reality Toolkit Extensions, Mixed Reality Toolkit Foundation,Mixed Reality Toolkit Standard Assets。

  10. 勾选Platform Support下面的 Mixed Reality OpenXR Plugin和Mixed Reality Moving Platform SDK。

  11. 点击Get Features

  12. 点击Import

  13. 点击Approve

  14. 点击Exit

打开Unity项目

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

Warning: Do you want to enable the backends? Doing so will *RESTART* the editor. 选择Yes。

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

配置Unity项目

打开项目后你应该可以看到MRTK Project Configurator窗口，如果没有看到，请点击菜单栏Mixed Reality

->Toolkit->Utilities->Configure Project for MRTK。

  1. 点击MRTK Project Configurator窗口中的Unity OpenXR plugin (recommended)，等待一段时间

  2. 出现Project Settings窗口，点击Fix all,如果没有出现Project Settings窗口，点击MRTK Project Configurator窗口中的Show XR Plug-in Management Settings。

  3. 在XR Plug-in Management窗口点击Windows标徽（Universal Windows Platform settings），勾选Initialize XR on Startup，勾选OpenXR，勾选Microsoft HoloLens feature group。

  4. 此时OpenXR旁边有黄色感叹号，点击感叹号，点击Fix all，如果点击一次之后，还有需要Fix的，请再点击几次，直到没有需要Fix的项目。

  5. 只剩下一个黄色感叹号显示Edit按钮，点击Edit按钮

  6. 在Interaction Profiles下，点击加号分别添加Eye Gaze Interaction Profile,Microsoft Hand Interaction Profile,Microsoft Motion Controller Profile,如果遇到黄色感叹号，点击黄色感叹号，点击Fix all。

  7. （可选）点击左侧的OpenXR选项，将Depth Submission Mode修改为Depth 16 Bit

  8. 关闭Project Settings窗口

  9. 到MRTK Project Configurator窗口，点击Apply Settings，如果仍然后黄色感叹号，点击Fix all。

  10. 没有黄色感叹号时，选择Next

  11. 点击Apply->Next->Import TMP Essentials->Got it, next->Done

  12. 重启Unity，如果遇到Scenes Have Been Modified，选择Save

创建场景并配置MRTK

  1. 可以新建一个场景，或者使用Sample场景，在这里我们新建一个场景
  2. 选择File->New Scene->Basic(Built-in)->Create
  3. 点击菜单栏的Mixed Reality->Toolkit->Add to Scene and Configure
  4. 程序会自动添加游戏物体到场景中，MixedRealityToolkit 对象包含工具包本身。 MixedRealityPlayspace 对象可确保在场景中正确管理头戴显示设备/控制器和其他必需系统。“Main Camera”对象成为 MixedRealityPlayspace对象的子对象。 这使得游戏区域能够与SDK同时管理摄像机。
  5. 按Ctrl+S，保存场景，选择Assets->Scenes文件夹，输入场景名称保存

这样就完成了HoloLen2的MRTK2配置。