注:本教程来源 微软官方文档
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 项目
- 启动 Unity。
- 选择“New” 。
- 输入项目名称(例如“MixedRealityBase”)。
- 输入保存项目的位置。
- 请确保将项目设置为“3D” 。
- 单击“Create Project” 。
配置用于 Windows Mixed Reality 的 Unity 项目
- 转到 “File > Build Settings”, 打开 “Build Settings” 窗口。
- 通过选择"Universal Windows Platform"切换到通用 Windows 平台。 单击 “Switch Platform” 按钮切换平台。 在 HoloLens 2 上运行的应用程序需要与通用 Windows 平台 (UWP) 兼容。
- 通过单击 " Build" 窗口中的 “Player Settings” 启用虚拟现实, 然后在 “Inspector” 面板中的 “XR Settings” 下启用 “Virtual Reality Supported” 复选框, 如下图所示。 请注意, 您可能需要将 “Build Settings” 窗口拖出, 以查看Inspector面板。 “Virtual Reality Supported” 复选框还适用于混合现实和增强现实头显, 因为它指的是启用立体视觉效果 (每个眼睛呈现不同的图像)。
- 在相同的Inspector面板中, 确保在 “Publishing Settings” 下启用 “Capabilities” 部分中的 “Spatial Perception” 复选框。 空间感知使我们能够在混合现实设备上 (如 HoloLens 2) 直观显示空间映射网格。 发布设置位于 “Inspector” 面板中的 “XR Settings” 和 “Other Settings” 的中间。
注意:虽然本教程未使用, 但你可能想要启用其他一些 包括麦克风(用于语音命令) 以及 InternetClient(用于连接到需要网络连接的服务) 的常见功能。
导入混合现实工具包(MRTK)
- 下载MRTK Unity package, 并将其保存到电脑上的文件夹中。
- 通过单击”Assets”>“Import”>“Custom Package”导入混合现实工具包。 找到下载的混合现实工具包并将其打开以开始导入过程。 导入过程需几分钟。
- 在下一个弹出窗口中, 单击 “Import” 以开始导入混合现实工具包。 确保所有项都已选中, 如图所示。 如果你看到一个弹出对话框, 要求应用混合现实工具包默认设置, 请单击 “应用”。
配置混合现实工具包
-
通过从菜单栏中选择 “Mixed Reality Toolkit” > “Configure” 来配置 MRTK。 如果在导入混合现实工具包后没有看到此菜单项,请重启 Unity。
[注意]:你可能会看到一个弹出对话框, 要求为混合现实工具包选择一个配置文件。 如果是, 请选择 “确定”, 然后选择名为 “DefaultMixedRealityToolkitConfigurationProfile” 的配置文件。 -
你的场景将在 MRTK 中有多个新项和修改。 单击 “File” > “Save As”, 将场景保存在其他名称下, 并为场景指定名称, 例如 BaseScene。 通过将场景保存到项目的 “Assets” 文件夹中“Scenes”的文件夹, 使场景保持有序。
在设备上构建应用程序 -
如果关闭了前面几节中的 “Build Settings” 窗口, 请通过转到 “文件 > Build Settings”, 重新打开 “Build Settings” 窗口。
-
单击 “Add Open Scenes” 按钮, 确保你想要尝试的场景处于 “Build” 列表中的场景中。
-
按”Build”按钮开始生成过程。
-
为应用程序创建一个新文件夹并为其命名。 在下图中, 创建了一个包含应用程序的名称为 “App” 的文件夹。 单击 “Select Folder”, 开始生成到新创建的文件夹。 完成生成后, 可以关闭 Unity 中的 “Build Settings” 窗口。
[注意]:如果生成失败,尝试再次生成或重启 Unity 并再次生成。 如果看到错误, 如 "错误:CS0246 = 找不到类型或命名空间名称 “XX” (是否缺少 using 指令或程序集引用?)。 如果是这样, 则可能需要安装Windows 10 SDK (10.0.18362.0) -
生成完成后,打开包含新生成的应用程序文件的新创建的文件夹。 双击 “MixedRealityBase” 解决方案或相应的名称 (如果你使用的是项目的备用名称) 以在 Visual Studio 中打开解决方案文件。
注意:如果遵循前面步骤中的命名, 请确保打开的是新创建的文件夹 (即 App 文件夹), 因为在该文件夹内外均有同名的.sln文件,这样不会因为名称而相混淆。
注意:如果 Visual Studio 要求你安装新组件,请花一点时间确保按照“安装工具”页面中的说明安装所有必备组件 -
将 HoloLens 2 连接到您的 PC。 尽管这些说明假设你要使用 HoloLens 2 设备部署测试, 但你也可以选择将部署到hololens 2 模拟器, 或选择创建用于旁加载的应用包
-
在部署到设备之前,请确保设备处于开发者模式。 如果这是你首次部署到 HoloLens 2, 则 Visual Studio 可能会要求你将 HoloLens 2 与 PIN 配对。 如果需要启用开发者模式或与 Visual Studio 配对,请按照这些说明进行操作。
-
通过选择 “发布” 配置和 ARM 体系结构, 将 Visual Studio 配置为生成到 HoloLens 2。
-
最后一步是通过选择 “调试” > “开始执行 (不调试)” 来生成设备。 如果选择 “启动但不调试”, 则会导致应用程序在成功生成后立即开始, 但不会在 Visual Studio 中显示调试信息。 这也意味着可以在 HoloLens 2 上运行应用程序时断开 USB 连接,而无需停止应用程序。 你还可以选择 “Build” > 部署解决方案以部署到设备, 而无需应用程序自动启动。
祝贺
现在, 你已部署了第一个 HoloLens 2 应用程序。 浏览时, 应该会看到一个空间网格, 其中包含已由 HoloLens 2 检测到的所有表面。 此外, 你应该看到在你手和手指上用于手部追踪的指示器, 以及用于跟踪应用程序性能的帧速率计数器。 这些只是混合现实工具包中现成可用的一些基本功能。 在接下来的教程中, 您开始向场景添加更多内容和交互性, 以便您可以充分探索 HoloLens 2 的功能和混合现实工具包。