HoloLens 仿真器包括 HoloLens 开发工具集，可让你在未配备物理 HoloLens 的电脑上测试全息应用程序。 该仿真器使用 Hyper-V 虚拟机，这意味着 HoloLens 传感器读取的人类和环境输入通过键盘、鼠标或 Xbox 控制器模拟。 项目甚至无需经过修改即可在仿真器上运行，并且应用不知道其不是在真实的 HoloLens 上运行。

如果想要开发适用于台式机的 Windows Mixed Reality 沉浸式 (VR) 头戴显示设备应用程序或游戏，请查看 Windows Mixed Reality 模拟器，该设备可用于模拟桌面头戴显示设备。

下载 HoloLens 仿真器。

版本：

HoloLens 仿真器结合使用 Hyper-V 和 RemoteFx（第 1 代仿真器）或 GPU-PV（HoloLens 2 仿真器）来实现图形硬件加速。 若要使用仿真器，请确保电脑符合以下硬件要求：

注意

Windows 10 家庭版不支持 Hyper-V 或 HoloLens 仿真器。 HoloLens 2 仿真器需要 Windows 10 2018 年 10 月更新版或更高版本。

如果你的系统满足上面列出的要求，请确保已在系统上启用“Hyper-V”功能。 转到“控制面板”-“程序”->“程序和功能”->“打开或关闭 Windows 功能”，并检查是否选中了“Hyper-V”。

注意

使用 Unity 时，请从 Unity 生成项目，然后像往常一样将生成的解决方案载入 Visual Studio。

仿真器在首次启动时，可能需要花费一分钟或更长的时间来完成引导。 建议在调试会话期间让仿真器保持打开状态，以便将应用程序快速部署到仿真器。

控制仿真器与控制许多常见的 3D 视频游戏相似。 可以通过输入选项来使用键盘、鼠标或 Xbox 控制器。 通过定向佩戴 HoloLens 的模拟用户执行的操作来控制仿真器。 你的操作可在环境中四处移动该模拟用户。 仿真器中运行的应用程序可以像在真实设备上一样做出响应。

HoloLens（第 1 代）上的光标可跟踪头部运动和旋转。 在 HoloLens 2 仿真器中，光标跟踪手部运动和方向。

有 Windows Mixed Reality 沉浸式头戴显示设备？ 从 HoloLens 2 仿真器（Windows 全息版 2004）开始，可以使用 Windows Mixed Reality 沉浸式头戴显示设备和运动控制器来控制 HoloLens 2 仿真器，并以立体方式观看它。 请参阅将 Windows Mixed Reality 沉浸式头戴显示设备和运动控制器与 HoloLens 2 仿真器配合使用

在主窗口的右侧，可以看到仿真器工具栏。 工具栏包含以下按钮：

使用模拟控制面板可以查看模拟人类和输入设备的当前位置与方向。 使用它还可以配置模拟输入（例如，显示或隐藏一只或两只手）和用于控制模拟输入的设备（例如电脑的键盘、鼠标和游戏手柄）。

在“帐户”选项卡中，可将仿真器配置为使用 Microsoft 帐户登录。 在测试需要用户使用帐户登录的 API 时，此配置非常有用。 切换此选项需要完全关闭并重启 HoloLens 仿真器，使设置生效。 如果启用此选项，则后续启动仿真器时，系统会要求你登录，就像用户首次启动 HoloLens 时一样。 若要使用电脑键盘输入凭据，请先在模拟控制面板中关闭“使用键盘进行模拟”，或按键盘上的 F4 打开或关闭键盘设置。

“可选设置”选项卡显示用于启用或禁用硬件加速图形的控件。 默认情况下，如果电脑的图形适配器驱动器支持硬件加速图形，则会使用硬件加速图形。 如果图形适配器的驱动程序不支持 GPU-PV，则不会显示此选项。

“诊断”选项卡以 Windows 设备门户链接的形式显示仿真器的 IP 地址，以及虚拟 GPU 的状态。

“网络”选项卡显示仿真器的网络适配器详细信息，以及主机的网络适配器详细信息。 对于 HoloLens 2 仿真器，只有在 Windows 10 2019 年 5 月更新版或更高版本上运行此仿真器时，此选项卡才会显示。

只有在 Windows 10 2019 年 5 月更新版或更高版本上运行此仿真器时，此选项卡才会显示。

此仿真器使用电脑的网络连接，位于 NAT 后面。 可以通过此选项卡将端口从主机电脑映射到仿真器，使远程设备能够连接到在仿真器中运行的应用程序和服务。

例如，如果需要从远程电脑访问仿真器上的设备门户，请执行以下操作：

另请注意，如果为设备门户添加端口映射，则可以远程方式控制仿真器，方法是：使用包括在仿真器安装中的“感知模拟控制”工具，或者使用感知模拟 API，只需连接到主机电脑的 IP 地址和设备门户的外部端口（例如以上示例中的 8080）即可。 使用感知模拟控制连接到仿真器并对其进行远程控制时，请仅指定电脑的 IP 地址和配置的端口。 不要包含“https://”。

默认情况下，没有端口映射。 多次启动 HoloLens 2 仿真器时，配置的任何映射都会保持不变，并且会在仿真器完全启动后自动启用。

请使用“导出”按钮将映射保存到文件。 然后，可以将此文件与其他可以使用“导入”按钮自动配置相同映射的团队成员共享。

只有在 Windows 10 2019 年 5 月更新版或更高版本上运行此仿真器时，此选项卡才会显示。

启动时，仿真程序会检查是否有新版本。 如果有可用的新版本，仿真程序会显示一个提示（其中会显示你的现有版本和可用版本），并询问你是否希望更新。 如果你选择“是”，系统会下载新版本的安装程序。

使用“更新”选项卡，你可以通过在其上切换“自动检查更新”复选框来控制是否允许仿真程序检查新版本。还可以通过它查看和下载其他可用的仿真程序版本（从 2019 年 9 月更新版开始）。 除当前正在运行的版本之外的其他版本都提供了下载链接。 单击该链接会下载该版本的安装程序。

从 HoloLens 2 仿真器（Windows 全息版 2004）开始，可以使用 Windows Mixed Reality 沉浸式头戴显示设备和运动控制器，以立体方式观看 HoloLens 2 仿真器并与之交互。 这样，你便可以在没有 HoloLens 2 设备的情况下利用头部和手部进行更快、更自然的运动。 这并非用于完全替代 HoloLens 2 设备，而是旨在提供改善的体验，使用户不仅仅能够在 2D 桌面窗口中使用键盘、鼠标和手柄与仿真器进行交互。 若要启用此功能：

在头戴显示设备中查看内容时遇到问题？

如果已保存配置，并想要删除它，则可以在 HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\PerceptionSimulation 下删除名为“DisplayConfiguration”的值。 如果当前正在将头戴显示设备与仿真器配合使用，则需要禁用“使用 HMD 进行仿真”并将其重新启用，才能看到此更改生效。

当仿真器启动时，你会看到一个显示 HoloLens OS 的窗口。

在主窗口的右侧，可以看到仿真器工具栏。 工具栏包含以下按钮：

“其他工具”窗格中的默认选项卡是“模拟”选项卡。

“模拟”选项卡显示用于在仿真器中驱动 HoloLens OS 的模拟传感器的当前状态。 将鼠标悬停在“模拟”选项卡中的任一值上会显示工具提示，其中描述了如何控制该值。

仿真器以模拟“房间”的空间映射网格形式模拟世界坐标输入。 使用此选项卡可以选择要加载的房间而不是默认房间。

有关详细信息，请参阅模拟的房间。

在“帐户”选项卡中，可将仿真器配置为使用 Microsoft 帐户登录。 在测试需要用户使用帐户登录的 API 时，此配置非常有用。 选中此页上的框后，后续启动仿真器时，系统会要求你登录，如同用户首次启动 HoloLens 时那样。

模拟的房间可用于在多个环境中测试应用程序。 仿真器随附了多个房间。 安装仿真器后，可以在 %ProgramFiles(x86)%\Windows Kits\10\Microsoft XDE\（版本）\Plugins\Rooms 中找到这些房间。 所有这些房间是使用 HoloLens 在真实环境中捕获的：

也可以在 HoloLens（第 1 代）上使用 Windows 设备门户的“模拟”页录制你自己的房间，以便在仿真器中使用它们。

在仿真器中，你只会看到自己渲染的全息影像。 但你会看到全息影像后面的模拟房间。 而在实际的 HoloLens 中，你会同时看到两者的混合形式。 若要在 HoloLens 仿真器中查看模拟的房间，需要更新应用程序，以便在场景中渲染空间映射网格。

安装仿真器时，可能会出现错误消息，指出需要“Visual Studio 2015 Update 1 和 UWP 工具版本 1.2”。 出现此错误的三个可能原因如下：

此外，在 Windows 的非专业版/企业版/教育版 SKU 上安装仿真器，或者未启用 Hyper-V 功能时，也可能会看到错误。

如果安装成功完成，但未看到 HoloLens 仿真器作为一个部署和调试选项列出：

如果安装成功完成，但尝试启动 HoloLens 仿真器时 Visual Studio 显示错误：

如果启动时仿真器显示“无效的字节编码”错误对话框：

如果 Visual Studio 中的调试目标列表为空（例如，“启动”是唯一选项），并且你已遵循上述所有故障排除步骤：

如果仿真器启动时系统挂起，请对仿真器图形禁用硬件加速。

如果 Hololens2 仿真器未响应键盘或鼠标输入，请尝试禁用 VPN 连接。