HoloLens2+Unity3d 2020.3+MRTK 2.7环境配置说明

本说明适用于：
Unity3d-2020.3.16
MRTK-2.7.0+Openxr

一、参考资料

MRTK-Unity 开发人员文档 - Mixed Reality Toolkit | Microsoft Docs

混合现实文档 - Mixed Reality | Microsoft Docs

HoloLens 2 fundamentals: develop mixed reality applications - Learn | Microsoft Docs/

二、环境配置说明

2.1 U3D版本说明

微软推荐使用Unity 2020.3 LTS,可通过Unity Hub下载。安装U3D时需添加Universal Windows Platform Build Support和Windows Build Support (IL2CPP)模块，如下图所示。

Choosing a Unity version and XR plugin - Mixed Reality | Microsoft Docs
https://docs.microsoft.com/en-us/windows/mixed-reality/develop/unity/choosing-unity-version

2.2 混合现实功能工具

从MRTK 2.5.0 开始，可以通过混合现实功能工具（Mixed Reality Feature Tool）“快速”进行U3D环境配置。

MRTK 2.4.0 配置方法可参见：
Unity+MRTK 2.5+HoloLens2开发环境配置与部署_shedipai0528的博客-CSDN博客
https://blog.csdn.net/shedipai0528/article/details/109216073

2.2.1 混合现实功能工具下载

0积分下载：混合现实功能工具（MixedRealityFeatureTool-1.0.2111.1）-Unity3D文档类资源-CSDN文库
最新版下载：Download Mixed Reality Feature Tool from Official Microsoft Download Center

2.2.2 混合现实功能工具使用说明

使用 Unity 包管理器 - 混合现实工具包 | 微软文档
https://docs.microsoft.com/en-us/windows/mixed-reality/mrtk-unity/configuration/usingupm?view=mrtkunity-2021-05#managing-mixed-reality-features-with-the-unity-package-manager
欢迎使用混合现实功能工具 - 混合现实 | 微软文档
https://docs.microsoft.com/en-us/windows/mixed-reality/develop/unity/welcome-to-mr-feature-tool

三、操作流程

参考资料：
Exercise - Import and configure resources - Learn | Microsoft Docs
https://docs.microsoft.com/en-us/learn/modules/learn-mrtk-tutorials/1-5-exercise-configure-resources#tabpanel_1_winxr

3.1 创建工程

启动Unity Hub创建新的项目，注意事项如下：

1. Unity 版本选为2020.3（2021版还没试过…）
2. 模板设置为3D

3.2 切换构建平台

1.在 Unity 菜单中，选择File > Build Settings…打开 Build Settings。

2.在 Build Settings 中，选择Universal Windows Platform并完成以下设置：

• Set Target device to HoloLens
• Set Architecture to ARM 64（此处与U3D 2019/2020+window xr不同）
• Set Build Type to D3D Project
• Set Target SDK Version to Latest Installed
• Set Minimum Platform Version to 10.0.10240.0
• Set Visual Studio Version to Latest installed
• Set Build and Run on to Local Machine
• Set Build configuration to Release (there are known performance issues with -Debug)

3.选择 Switch Platform

3.3 导入和配置MRTK资源

注：以下说明适用于Unity2020+Openxr

引用大佬的话：
事实上，使用Unity 2020.3 开发MR应用，可以有两种配置，一种支持OpenXR标准，另一种不支持。不支持OpenXR标准的配置方式将会在Unity2021.3LTS中被移除，因此，本文我们只介绍支持OpenXR标准的配置，毕竟OpenXR才是未来。
HoloLens2之路－Unity2020.3+MRTK2.7配置_DavidWang-CSDN博客
https://blog.csdn.net/yolon3000/article/details/121776416

Unity 2019/2020+windows xr的配置流程可见：
Unity+MRTK 2.5+HoloLens2开发环境配置与部署_shedipai0528的博客-CSDN博客
https://blog.csdn.net/shedipai0528/article/details/109216073

1.打开MixedRealityFeatureTool 后，选择开始以启动混合现实功能工具。


2.选择项目路径旁边的省略号图标并浏览到您的项目文件夹,然后选择 Discover Features

注：混合现实功能工具执行验证以确保它已被定向到 Unity 项目文件夹。该文件夹必须包含 Assets、Packages 和 Project Settings 文件夹。

3.选择以下包：

• Mixed Reality OpenXR Plugin(必选) 混合现实 OpenXR 插件
• Mixed Reality Toolkit Foundation（必选）基础包
• Mixed Reality Toolkit Tools（个人建议选）包含一些实用工具：构建窗口、 优化窗口、UI工具箱
• Mixed Reality Toolkit Examples（个人建议选）示例包，新手必用

注：Mixed Reality Toolkit Extensions(扩展包)和Mixed Reality Toolkit Standard Assets（标准资源包）在下一步中，MRFT会自动帮你勾选

各包的详细介绍，参见：
MRTK packages - Mixed Reality Toolkit | Microsoft Docs
https://docs.microsoft.com/en-us/windows/mixed-reality/mrtk-unity/packages/mrtk-packages?view=mrtkunity-2021-05#examples-package

4.选择Get features,然后选择 Validate 以验证所选包,系统应返回未检测到验证问题

6.选择 Import，然后选择 Approve 以将混合现实工具包添加到您的项目中。

3.4 配置 Unity 项目

1.Unity 导入包后，选择Yes重新启动 Unity 编辑器以启用新插件的后端。

2.应出现 MRTK 项目配置器。如果没有，请通过选择Mixed Reality > Toolkit > Utilities > Configure Project for MRTK手动打开它

3.选择Unity OpenXR 插件以启用 XR 插件管理并将其所需的包添加到您的项目中。

4.导入 XR 插件管理所需的 Unity 包后，在 MRTK 项目配置器中选择显示 XR 插件管理设置。

5.项目设置打开。在XR Plug-in Management下，确保 Universal Windows Platform settings（Windows 徽标选项卡）处于活动状态，然后确保Initialize XR on Startup、Open XR和Microsoft HoloLens 功能组均已启用（选中复选框）。

注：这里大坑来了，官方说明里Open XR后面是没有感叹号的，若有参见下一步
HoloLens2之路－Unity2020.3+MRTK2.7配置_DavidWang-CSDN博客
https://blog.csdn.net/yolon3000/article/details/121776416

6.点击黄色三角警示牌，弹出要求修复问题的面板，点击"Fix All"进行修复


7.修复完之后，会修复下面3个Fix，但还会余留一个Edit。点击“Edit”按钮，然后关闭该弹出面板。在新打开的界面中添加“Microsoft Hand Interaction Profile”和“Microsoft Motion Controller Profiler”这两个配置文件。

注：如果需要眼动，再添加Eye Gaze Interaction Profile配置文件（我也不知为什么，不加没眼动，加了才有）

8.在MRTK Project Configurator更新消息上，选择Apply Settings。要验证 OpenXR 配置，请在XR Plug-in Management下选择OpenXR并确认已选中以下项目：

• Depth Submission Mode: Depth 16 Bit
• Interaction Profiles: Microsoft Hand Interaction Profile（第7步已添加）

9.在MRTK 项目配置器窗口中，选择Next，然后选择Apply。（您可以从Mixed Reality > Toolkit > Utilities > Configure Project for MRTK手动打开配置器）

10.Unity 必须重新启动才能使配置生效。出现提示时，选择应用以重新启动 Unity 编辑器。

3.5 为 OpenXR 配置项目设置

1.在 Unity 菜单中，选择Edit > Project Settings…打开Project Settings。
2.在Project Settings中，选择Player > Publishing Settings，然后在Package name字段中，输入合适的名称

“Package name”是应用程序的唯一标识符。您应该在部署应用程序之前更改此标识符以避免覆盖以前安装的应用程序。
“Product Name”是 HoloLens 开始菜单中显示的名称。为了使应用程序在开发过程中更容易定位，请在名称前添加下划线以将其排序到任何列表的顶部。

3.6 更新工程设置

在Unity菜单中，依次选择Mixed Reality->Project->Apply recommended project settings for HoloLens2，对当前开发环境进行更新。

3.7 创建场景并配置 MRTK

1.在 Unity 菜单中，选择File > New Scene
2.在New Scene窗口中选择Basic (Built-in)并单击 create创建一个新场景
3.在 Unity 菜单中，选择Mixed Reality > Toolkit > Add to Scene and Configure…以将 MRTK 添加到当前场景
4.在Hierarchy 窗口中仍选择MixedRealityToolkit对象的情况下，在 Inspector 窗口中，验证MixedRealityToolkit配置文件是否设置为DefaultHoloLens2ConfigurationProfile

5.在 Unity 菜单中，选择File > Save As…打开 Save Scene 窗口
6.将场景保存在Asset > Scenes下的项目中

四、导入示例场景

1.若第3.3节导入了Mixed Reality Toolkit Examples包，则直接点击Mixed Reality->Toolkit->Utilities->Import Examples from Package(UPM)，打开Package Manager窗口

2.在面板右侧的列表中，单击示例场景名称旁的 “Import” 按钮导入

3.导入后，将可以在 " Assets->Samples " 文件夹下找到它们。 HandInteractionExamples 场景是开始体验 MRTK 的空间交互和 UI 构建基块的好地方。

示例场景 - Mixed Reality Toolkit | Microsoft Docs
https://docs.microsoft.com/zh-cn/windows/mixed-reality/mrtk-unity/running-example-scenes?view=mrtkunity-2021-05