基于MRTK的Hololens开发入门

MRTK简介

混合现实工具包(MRTK)是用于为虚拟现实(VR)和增强现实(AR)构建混合现实体验的跨平台工具包，它包含脚本和组件的工具，微软设计MRTK的目的在于加速基于Hololens及Windows 平台MR头戴设备应用的开发。

开发初始准备

开发所需配置如下：

基础软件.png

若要生成Hololens（1代）应用程序，可以使用Visual Studio 2017安装的Windows SDK。
若要生成Hololens 2 应用程序，必须安装Windows SDK版本10.0.18362或更高版本。
注意：如果Hololens1开发用到MRTK V2的插件，则Windows SDK要选择基于运行设备合适的版本。

基础设置

Mixed Reality Toolkit下载

1.选择需要的版本进行下载，MRTK下载地址。
2.在Assets下，下载

Microsoft.MixedRealityToolkit.Unity.Foundation.unitypackage
Microsoft.MixedRealityToolkit.Unity.Examples.unitypackage（包含示例）

Mixed Reality Feature Tool下载

1.进入官网进行下载，MRFT下载地址。
2.下载完成后，启动程序，选择一个unity项目（需包含Assets、Package、Package Settings的文件夹）作为路径。
3.此时跳转到下载界面，可以根据自己需求来下载相应的资源包，MRFT会根据选择，补充下载其他所需资源包。

资源包下载界面

Example资源包其余所需资源包

4.选择import后打开之前选择的Unity项目，会发现正在导入资源包，待导入完成后，资源包都会在Package目录下。

注意：导入后可能会出现如下的报错，这说明可能下载出现问题导致资源包不完整，找到已下载的资源包，检查大小是否有偏差，若有则删除该资源包，重复第三步。

An error occurred while resolving packages:
Project has invalid dependencies:
com.microsoft.mixedreality.toolkit.examples: zlib: unexpected end of file

5.要使用MRTK-Example中的示例，需要先找到项目所在文件夹，在文件中找到Package -> Examples ->Samples~，将Samples~文件夹名称尾部的“~”去掉，再移到Assets目录下方可使用。

将MRTK导入Unity项目中

1.打开Unity，创建一个新项目或者打开一个项目，创建项目请选择3D作为模板类型。
2.选择Asset -> Import Package -> Custom Package，找到MRTK保存路径，将MRTK资源包分别导入。
在导入Foundation资源包时，会出现以下提示，选择应用。

Foundation导入时.PNG

将Unity项目切换平台

1.打开FIle -> Build Settings。
2.点击PlayerSettings，选择Player -> XR Settings，勾选Virtual Reality Supported，并添加Virtual Reality SDKs，选择Windows Mixed Reality。

PlayerSetting界面设置

3.在Platform表项中选择Universal Windows Platform（通用Windows平台），点击Switch Platform。

Universal Windows Platform界面设置

注意：若选择Universal Windows Platform后，界面如下所示，点击Install with Unity Hub，下载完成后，重启Uniity即可。

若无下载过界面

将MRTK示例添加到新场景

1.在菜单栏中选择Mixed Reality Toolkit -> Add to Scene and Configue inspector。
2.场景中的Hierarchy会出现MixedRealityToolkit，即工具包本身，以及MixedReality Playspace，点击会出现Main Camera。
3.在Assets/MixedRealityToolkit.Examples/Demos/HandTracking/Scenes/HandInteractionExamples下打开HandInteractionExamples场景。
4.出现导入TMP Essentials提示，选择导入，导入成功后关闭提示框。

导入TMP Essentials提示框

将示例部署到设备

打包项目

1.打开FIle -> Build Settings。
2.在Platform表项中选择Universal Windows Platform，将Target Device选为Hololens，将Minimum Platform Version选为可适配的最小版本，将Build configuration选为Debug。
3.点击Build。

部署到Hololens界面设置

Visual Studio设置

Hololens 1代设备部署
1.打开Unity打包项目。
2.调试选择Debug模式，x86架构，部署目标选择设备。
3.第一次将应用从电脑部署到Hololens时，系统会提示输入目标设备PIN，进入Hololens设置中的Update and Security找到For Developers，点击Pair，将显示的PIN输入到电脑上。
4.选择调试 -> 开始调试。
5.戴上Hololens设备，在应用中找到示例项目，打开即可测试。

Hololens 2代模拟器部署
1.安装Hololens 2 Emulator，确保装在默认路径C盘中，以便Visual Studio可以识别到。
2.打开Unity打包项目。
3.调试选择Debug模式，x86架构，部署目标选择Hololens 2 Emulator。
4.选择调试 -> 开始调试。
5.模拟器会自动打开，等候项目加载完毕即可测试。