Hololens2项目基础开发

目录

一、前言

二、VS2019负载安装

三、Hololens2项目环境配置

四、项目具体功能实现

五、打包部署真机测试

---

一、前言

Hololens2项目基础开发包含：单（双）手近距离控制物体移动旋转、双手近距离控制物体的缩放、语音功能（控制物体生成、缩放等）、凝视功能、空间映射等。

Unity版本+MRTK版本适配选择：2019.4.40.f1c1+MRTK2.6.2

编辑器选择：VS2019

在Hololens2项目环境配置中，项目需要什么功能就克隆相应的配置文件并进行相应的修改。

MRTK资源及项目具体功能实现中所需的脚本下载：https://download.csdn.net/download/pxsbxzw/87408374

HoloDemo工程文件：https://download.csdn.net/download/pxsbxzw/87408384

二、VS2019负载安装

Hololens2 + VS2019负载安装_CV工程师2.0的博客-CSDN博客_vs2019要安装哪些工作负载

三、Hololens2项目环境配置

1.新建一个项目HoloDemo，选择Unity的版本为2019.4.40.f1c1（也可以使用其它版本，本教程使用的是2019.4.40+MRTK2.6.2）。

2.将MRTK基础包、扩展包、工具包导入Unity项目HoloDemo中。

• 基础包：混合现实工具基础是使应用程序能够跨混合现实平台利用通用功能的代码集。
• 扩展包：包括扩展 Microsoft 混合现实 Toolkit 功能的其他服务（包含关节手添加物理支持的服务、简化HoloLens 设备上的跟踪丢失处理的服务、简化顺畅场景过渡添加过程的服务）。
• 工具包：有助于使用 Microsoft 混合现实 Toolkit 增强混合现实开发体验的工具。 这些工具位于 Unity 编辑器中的“混合现实工具包>实用工具”菜单中。
• 示例包：包含演示、示例脚本和示例场景，用于练习基础包中的功能。

  

3.将基础包（Foundation）拖到Project/Asset下后，点击导入，然后点击Apply。

4.将拓展包（Extensions）和工具包（Tools）拖到Project/Asset下后，点击导入。

5.切换平台，点击File/Build Settings，选择UWP平台，点击SwitchPlatform切换到UWP平台。

6.切换完成后，会出现MRTK Project Configurator，点击Apply。

7.在场景中添加MRTK配置，点击窗口栏中的MixedRealityToolkit/Add to Scene And Configure。

添加完成后，Hierarchy窗口会变成下图所示的样子

8.选择Hierarchy窗口下的MixedRealityTookit（关于MRTK配置的选择与区别，请看文档MRTK配置区别，在该项目中采用默认配置文件），点击Clone出现CloneProfile面板，修改配置文件名称，然后点击Clone，只有克隆了才能修改配置（统一取名为默认名称+“_Demo”）。

9.选择Hierarchy窗口下的MixedRealityTookit，将配置文件选择成Clone的配置文件（MixedRealityToolkitConfigurationProfile_Demo）。然后选择Camera，点击Clone。

10.选择Hierarchy窗口下的MixedRealityTookit，选择Camera，展开Camera Settings Providers，点击Clone。

11.所有的配置都在Hierarchy窗口下的MixedRealityTookit中，下文就不一一说明了，在第10步的基础上勾选Render from PV Camera（Align Holograms），勾选主要作用是校准录屏后虚拟跟现实场景画面的偏差。

 12.本教程会用到语音识别、空间映射等功能，所以还需要克隆Input和Spatial Awareness，克隆操作同上，如果觉得HoloLens下边那个调试框比较碍事，可以克隆Diagnostics，然后关闭。

13.语音识别具体使用，点击添加，然后主键设置为重置场景。

14.创建一个空物体，挂载一个SpeechInputHandler脚本。

15.在14步操作基础上点击+，输入Keyword为重置场景，将重置场景的代码所挂载的物体拖入，选择具体实现的方法。

16.第13-15步是MRTK调用语音识别的具体步骤，比较繁琐。后续会用脚本直接控制语音命令。克隆SpatialAwareness中的配置文件。

17.调整Spatial Awareness中的参数，是否自动开启，刷新时间，网格大小，网格数量，是否显示网格等参数，可以自行调整。

18.打开File/Build Settings，点击Player Settings,在Project Settings中选中Player，修改公司名称为HoloDemo（同时将Package name和Descrpition也修改为HoloDemo）。

 

 19.在Player/Publishing Settings下启用权限（InternetClient，InternetClientServer，PrivateNetworkClientServer这三个是网络权限；WebCam，Microphone，SpatialPerception，GazeInput）。

  20.在Player/XR Settings下，勾选Virtual Reality Supported。

 21.在Mixed Reality Toolkit/Utilities/Configure Unity Project中可以查看相关配置。

 

 从2-21步就完成了项目相关的所有配置。

四、项目具体功能实现

1.在Project窗口下右键Assets，创建一个空文件，命名为Scripts，将资源文件中的VoiceControl脚本拖到Scripts文件下。

 2.在Hierarchy窗口中，右键创建一个空物体，命名为Root（选中空物体，按F2改名为Root）。

 3.将脚本VoiceControl挂载到空物体Root下面。

 4.在Hierarchy窗口右键创建一个Cube，将Cube的Scale设置为0.1（UWP平台下的1在现实生活中就是1米）。

 5.将创建的Cube制作成预制体，将Cube拖动到Project窗口下的Assets中。

6. 删除Hierarchy窗口下的Cube，选中空物体Root，将Project窗口下的Assets下的预制体Cube拖到Voice Control脚本的Prefab中。

 7.将资源文件中的Hit脚本拖到Scripts文件下。

 8.将Hit脚本挂载到Cube预制体上。

 9.点击File/Build Settings，在Build Settings面板中点击Build进行打包。

 10.点击Build后，会自动打开Windows的窗口，需要选择一个打包路径，默认会打开项目所在的目录，在项目目录中创建一个文件夹Build，选择Build为打包目录，点击选择文件夹后，项目开始打包（注意项目路径尽量不要有中文，打包路径也不要用，路径存在中文可能会报错）。

 11.打包完成后，在Build文件夹下，会生成下图几个文件，代表打包成功。

 

五、打包部署真机测试

1.双击打开Build文件夹中的HoloDemo.sln文件。

 2.选择打包方式为Release，ARM64和设备，然后点击运行。

 如果是第一次部署到真机，可能需要Hololens的配对码，Hololens的配对码在Hololens的更新和安全/面向开发人员，在面向开发人员的面板中点击配对，会出现配对码。