Hololens开发

第一章-软件要求

第二章-Unity环境配置

2.1 - Hololens2 插件下载

1. 请从 Microsoft 下载中心下载混合现实功能工具的最新版本。

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

   

3. 在混合现实功能工具中，选择“启动”。

   

4. 选择“浏览”按钮（它是下图中的“三个点”按钮），导航到你的项目，然后将其打开。

   

    备注

   该工具中的“项目路径”框必须包含某个值，因此默认情况下会插入一个反斜杠（“_”）。

   选择文件夹后，该工具会进行检查以确保它是有效的 Unity 项目文件夹。

   

5. 选择“Discover Features”。

   注意：工具刷新源中的包时可能需要等待几秒钟。

6. 在“发现功能”页上，请注意有 6 个包组的列表。

   

7. 单击“Mixed Reality Toolkit(0/10)”左侧的“+”按钮，然后选择“Mixed Reality Toolkit Foundation”的最新版本。

   “Mixed Reality Toolkit Foundation”包是唯一的包，必须将它导入并进行配置后，才能在项目中使用 MRTK。 此包中有创建混合现实应用所需的核心组件。

   单击“Platform Support(0/5)”左侧的“+”按钮，然后选择“Mixed Reality OpenXR Plugin”的最新版本。

   

8. 做出选择后，请单击“Get Features”。

9. 选择“验证”以验证所选的包。 应会看到一个对话框，显示“未检测到任何验证问题”。 完成后，单击“确定”。

10. 在“导入功能”页上，左侧列的“功能”将显示你刚刚选择的包。 右侧列的“必需依赖项”显示所有依赖项。 可以单击其中任一项的“详细信息”链接，了解相关详细信息。

11. 准备好继续时，选择“导入”。在“查看和批准”页上，可以查看有关包的信息。

12. 选择“批准”。

13. 返回到 Unity 编辑器，并单击 UI 中的空白区域。 你将看到一个进度栏，告知你正在导入你的包。

2.2 - 配置 Unity 项目

1. 将Unity平台转为 Universal Windows Platform，并将其配置改变为以下配置

2. Unity 导入包后，会出现一条警告，询问你是否要通过重启编辑器来启用后端。 选择 “是” 。

   

3. 系统应显示 MRTK 项目配置器。 如果未显示，请手动打开它：在菜单栏上，选择“Mixed Reality”>“Toolkit”>“Utilities”>“Configure Project for MRTK”：

   

4. 选择“Unity OpenXR Plugin”以启用 XR 插件管理，并将 Unity OpenXR Plugin添加到项目。

   

5. 在“Welacome to MRTK!”屏幕上，选择“Show XRPlugin-in Management Settins”。

   

6. 随即打开“项目设置”窗口。 确保你位于显示“通用 Windows 平台”设置（Windows 徽标选项卡）的“XR Plugin-in Management”页面上。

   

7. 确保选中“在启动时初始化 XR”，然后在“插件提供程序”下单击“打开 XR”。 若Ini

   

8. 加载 OpenXR 插件，然后在“OpenXR”下方出现两个项目。 选择第一个，即“Microsoft HoloLens 功能组”。

9. 请注意，现在 OpenXR 旁边有一个黄色的警告三角形。 将光标悬停在该三角形上，然后在弹出窗口中阅读该消息，然后选择该三角形。

   

10. 在“OpenXR 项目验证”窗口中，列出了几个问题。 选择“全部修复”按钮。

    

11. 一个问题仍然存在，并告诉你必须添加至少一个交互配置文件。 为此，请单击“Edit”。 这会转到“项目设置”窗口中“OpenXR”插件的设置。

12. 在“Intercation Profiles”下方，请注意加号 (+) 按钮。

13. 单击该按钮三次，每次选择不同的配置文件：

    Eye Gaze Interaction Profile

    Microsoft Hand Interaction Profile

    Microsoft Motion Controller Profile

    

    如果“眼睛凝视交互配置文件”或其他任何配置文件旁边出现黄色三角形，请选择该三角形，然后在“OpenXR 项目验证”窗口中，单击“修复”按钮。 完成后，关闭“OpenXR 项目验证”窗口。

    

14. 在“项目设置”窗口的“OpenXR 功能组”下，确保选中以下各项：

    Microsoft HoloLens

    Hand Tracking

    Motion Controller Model

15. 单击“深度提交模式”下拉列表，然后选择“深度 16 位”。

     提示  将深度格式减少到 16 位是可选的，但这可能会提高项目中的图形性能。  备注 “呈现模式”设置位于“深度提交模式”上方，默认设置为“单通道实例化”。 在混合现实应用中，场景会渲染两次：为每只眼睛渲染一次。 结果是“立体视觉”。这会使必要的计算量翻倍，因此在 Unity 中选择最有效的渲染路径以节省 CPU 和 GPU 时间非常重要。 单通道实例化渲染是这里的最佳选择，我们建议默认为每个项目启用它。

16. 关闭“项目设置”窗口。

17. 在“MRTK 项目配置器”窗口中，选择“Apply Settins”。

    

18. 选择“下一步”，然后选择“应用”。

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

2.3 - 为 OpenXR 配置项目设置

1. Unity 重启后，在菜单栏中，选择“Editor”>“ProjectSetting...”。

2. 在“项目设置”窗口的左侧列中，选择“Player”。

3. 请注意，在“Player”窗口中，“产品名称”是“MRTK Tutorial”。这取自你的项目名称，将是 HoloLens“开始”菜单中显示的名称。

   

    提示

   为了使应用在开发期间更易于查找，请在名称前添加一个下划线，以将其排列到任何列表的顶部。

4. 单击“Publishing Settings”下拉列表，然后在“Package Name”字段中输入合适的名称，例如 MRTK-Tutorials-Getting-Started：

   

    备注

   包名称是应用的唯一标识符。 如果要避免覆盖以前安装的同名应用版本，则应在部署应用之前更改此标识符。

5. 在“Publishing Settings”中找到"Capabilities"，勾选WebCam选项

6. 关闭“项目设置”窗口。

第三章-Visual Studio Installer 环境配置

第四章-Unity导出到Hololens

4.1导出UWP平台包体

4.2 使用VS导入到Hololens2中

使用VS打开上述sln文件，在调试处选择“Release-Arm-设备”

4.3 检查项目引用内是否存在黄色警告

此警告会在导入时弹出一个报错 “WindowsMobile  version 10.0.xxx.0”

首先这是一个历史遗留问题，无论是打包HoloLens1，还是HoloLens2，截止今天（2022年10月）仍旧没有修复，这确实是一个Bug，但不是Unity的Bug

Bug原因：

VS在编译的时候是默认UWP相关SDK在C:\Program Files (x86)\Windows Kits中的

解决方案一：

（扬汤止沸，每次打包都得操作一次）
在解决方案资源管理器中找到，[项目]>引用>Windows Mobile（带黄色感叹号），直接右键删掉

解决方案二：

（釜底抽薪，从根源解决问题）
把下载的WindowsMobile SDK从下载的目录，
[Windows Kit Root Dir]\10\Extension SDKs\WindowsMobile，
拷贝到
C:\Program Files (x86)\Windows Kits\10\Extension SDKs\

这么来说，网上流传的

1.重新安装Windows 10 SDK xxx 版本（版本问题说）
2.把Windows 10 SDK安装到C盘
3.把Visual Studio安装到C盘

这些方法就都不是正确的解决方法了 而且这个问题只要官方不修复，按道理说每个人都会遇到 因为，Window10SDK不能安装在URL过长的目录下，也就是说不能安装到VS编译时的默认目录 所以在问题修复之前，HoloLens开发者们只能硬生生踩到这个坑里了

4.4 Hololens2设置

进入Hololens2中，进入“设置”页面，选中“更新和安全>面向开发人员”，选中“使USE链接和本地网络能找到你的设备”，在点击配对按钮，将此Pin输入到一下输入框即可