HoloLens 2 开发101：创建首个HoloLens 2应用程序

注:本教程来源 微软官方文档
https://docs.microsoft.com/zh-cn/windows/mixed-reality/mrlearning-base
https://docs.microsoft.com/zh-cn/windows/mixed-reality/mrlearning-base-ch1
有细化和改动

1.概述和目标

本教程适用于:HoloLens 2

系统必备

• 使用安装了正确工具配置的 WINDOWS 10 电脑
• Windows 10 SDK 10.0.18362.0 或更高版本
• 一些基本C#的编程能力。
• 启用开发者模式的 HoloLens 2 设备。

2.初始化项目和首个应用程序

在本教程中, 您将了解到混合现实工具包 (MRTK) 必须提供的某些功能, 启动 HoloLens 2 的第一个应用程序, 并将其部署到设备。

目标

• 为HoloLens开发进行Unity的设置。
• 导入资源并设置场景。
• 空间网格、手部网格和帧率计数器的可视化。

说明

创建新的 Unity 项目

1. 启动 Unity。
2. 选择“New” 。
   
3. 输入项目名称（例如“MixedRealityBase”）。
   
4. 输入保存项目的位置。
   
5. 请确保将项目设置为“3D” 。
   
6. 单击“Create Project” 。
   

配置用于 Windows Mixed Reality 的 Unity 项目

1. 转到 “File > Build Settings”, 打开 “Build Settings” 窗口。
   
2. 通过选择"Universal Windows Platform"切换到通用 Windows 平台。 单击 “Switch Platform” 按钮切换平台。 在 HoloLens 2 上运行的应用程序需要与通用 Windows 平台 (UWP) 兼容。
   
3. 通过单击 " Build" 窗口中的 “Player Settings” 启用虚拟现实, 然后在 “Inspector” 面板中的 “XR Settings” 下启用 “Virtual Reality Supported” 复选框, 如下图所示。 请注意, 您可能需要将 “Build Settings” 窗口拖出, 以查看Inspector面板。 “Virtual Reality Supported” 复选框还适用于混合现实和增强现实头显, 因为它指的是启用立体视觉效果 (每个眼睛呈现不同的图像)。
4. 在相同的Inspector面板中, 确保在 “Publishing Settings” 下启用 “Capabilities” 部分中的 “Spatial Perception” 复选框。 空间感知使我们能够在混合现实设备上 (如 HoloLens 2) 直观显示空间映射网格。 发布设置位于 “Inspector” 面板中的 “XR Settings” 和 “Other Settings” 的中间。
   
   注意：虽然本教程未使用, 但你可能想要启用其他一些 包括麦克风(用于语音命令) 以及 InternetClient(用于连接到需要网络连接的服务) 的常见功能。

导入混合现实工具包（MRTK）

1. 下载MRTK Unity package, 并将其保存到电脑上的文件夹中。
2. 通过单击”Assets”>“Import”>“Custom Package”导入混合现实工具包。 找到下载的混合现实工具包并将其打开以开始导入过程。 导入过程需几分钟。
   
   
3. 在下一个弹出窗口中, 单击 “Import” 以开始导入混合现实工具包。 确保所有项都已选中, 如图所示。 如果你看到一个弹出对话框, 要求应用混合现实工具包默认设置, 请单击 “应用”。
   
   

配置混合现实工具包

1. 通过从菜单栏中选择 “Mixed Reality Toolkit” > “Configure” 来配置 MRTK。 如果在导入混合现实工具包后没有看到此菜单项，请重启 Unity。
   
   [注意]:你可能会看到一个弹出对话框, 要求为混合现实工具包选择一个配置文件。 如果是, 请选择 “确定”, 然后选择名为 “DefaultMixedRealityToolkitConfigurationProfile” 的配置文件。

2. 你的场景将在 MRTK 中有多个新项和修改。 单击 “File” > “Save As”, 将场景保存在其他名称下, 并为场景指定名称, 例如 BaseScene。 通过将场景保存到项目的 “Assets” 文件夹中“Scenes”的文件夹, 使场景保持有序。
   
   
   在设备上构建应用程序

3. 如果关闭了前面几节中的 “Build Settings” 窗口, 请通过转到 “文件 > Build Settings”, 重新打开 “Build Settings” 窗口。
   

4. 单击 “Add Open Scenes” 按钮, 确保你想要尝试的场景处于 “Build” 列表中的场景中。

5. 按”Build”按钮开始生成过程。
   

6. 为应用程序创建一个新文件夹并为其命名。 在下图中, 创建了一个包含应用程序的名称为 “App” 的文件夹。 单击 “Select Folder”, 开始生成到新创建的文件夹。 完成生成后, 可以关闭 Unity 中的 “Build Settings” 窗口。
   
   [注意]：如果生成失败，尝试再次生成或重启 Unity 并再次生成。 如果看到错误, 如 "错误:CS0246 = 找不到类型或命名空间名称 “XX” (是否缺少 using 指令或程序集引用？)。 如果是这样, 则可能需要安装Windows 10 SDK (10.0.18362.0)

7. 生成完成后，打开包含新生成的应用程序文件的新创建的文件夹。 双击 “MixedRealityBase” 解决方案或相应的名称 (如果你使用的是项目的备用名称) 以在 Visual Studio 中打开解决方案文件。
   注意:如果遵循前面步骤中的命名, 请确保打开的是新创建的文件夹 (即 App 文件夹), 因为在该文件夹内外均有同名的.sln文件，这样不会因为名称而相混淆。
   
   注意:如果 Visual Studio 要求你安装新组件，请花一点时间确保按照“安装工具”页面中的说明安装所有必备组件

8. 将 HoloLens 2 连接到您的 PC。 尽管这些说明假设你要使用 HoloLens 2 设备部署测试, 但你也可以选择将部署到hololens 2 模拟器, 或选择创建用于旁加载的应用包

9. 在部署到设备之前，请确保设备处于开发者模式。 如果这是你首次部署到 HoloLens 2, 则 Visual Studio 可能会要求你将 HoloLens 2 与 PIN 配对。 如果需要启用开发者模式或与 Visual Studio 配对，请按照这些说明进行操作。

10. 通过选择 “发布” 配置和 ARM 体系结构, 将 Visual Studio 配置为生成到 HoloLens 2。
    

11. 最后一步是通过选择 “调试” > “开始执行 (不调试)” 来生成设备。 如果选择 “启动但不调试”, 则会导致应用程序在成功生成后立即开始, 但不会在 Visual Studio 中显示调试信息。 这也意味着可以在 HoloLens 2 上运行应用程序时断开 USB 连接，而无需停止应用程序。 你还可以选择 “Build” > 部署解决方案以部署到设备, 而无需应用程序自动启动。
    

祝贺

现在, 你已部署了第一个 HoloLens 2 应用程序。 浏览时, 应该会看到一个空间网格, 其中包含已由 HoloLens 2 检测到的所有表面。 此外, 你应该看到在你手和手指上用于手部追踪的指示器, 以及用于跟踪应用程序性能的帧速率计数器。 这些只是混合现实工具包中现成可用的一些基本功能。 在接下来的教程中, 您开始向场景添加更多内容和交互性, 以便您可以充分探索 HoloLens 2 的功能和混合现实工具包。