使用Windows设备门户

HoloLens的Windows设备门户允许您通过Wi-Fi或USB远程配置和管理设备。设备门户是HoloLens上的一个web服务器，您可以从PC上的web浏览器连接到该服务器。设备门户包含许多工具，可帮助您管理HoloLen以及调试和优化应用程序。

本文档专门介绍用于HoloLens的Windows设备门户。要将Windows设备门户用于桌面（包括Windows混合现实），请参阅Windows设备门户概述

设置HoloLens以使用Windows设备门户

1. 打开HoloLens的电源并打开设备。
2. 使用开始手势对于HoloLens2或布鲁姆在HoloLens（第一代）上启动主菜单。
3. 凝视着设置平铺并执行空中地图HoloLens上的手势（第1代）。您也可以通过以下方式在HoloLens 2上选择它触摸或使用手电筒.
4. 选择更新菜单项。
5. 选择对于开发人员菜单项。
6. 启用开发人员模式.

7. 向下滚动并启用设备门户.
8. 如果您正在设置Windows设备门户，以便可以通过USB或Wi-Fi将应用程序部署到此HoloLens，请选择一对到生成配对PIN。将设置应用程序保留在PIN弹出窗口中，直到在首次部署期间将PIN输入Visual Studio。

通过Wi-Fi连接

1. 将HoloLens连接到Wi-Fi.
2. 通过以下任一方式查找设备的IP地址：

• 去设置>网络和互联网>Wi-Fi>高级选项.
• 去设置>网络和Internet并选择硬件属性.
• 使用“我的IP地址是什么？”语音命令。

3. 从PC上的网络浏览器访问https://<your_HOLOLENS_IP_ADDRESS>
   • 浏览器将显示以下消息：“此网站的安全证书有问题”，因为颁发给设备门户的证书是测试证书。您可以暂时忽略此证书错误并继续。

通过USB连接

1. 如果HoloLens 2运行的是Windows全息版本21H1或更高版本，请转到“设置”应用程序中的“供开发人员使用”，并确保“设备发现”已打开。
2. 使用USB-C电缆将HoloLens 2连接到PC。
3. 查找您的UsbNcm IP。有几种方法可以做到这一点：

• 在设备上的“设置”应用程序中（此方法仅适用于运行Windows Holographic版本21H1或更高版本的HoloLenses，并将“设备发现”切换为on。）

  1. 进入设备上的设置应用程序。
  2. 转到“更新与安全”>“针对开发人员”。这与您启用设备门户的位置相同。
  3. 在页面底部，复制您的以太网IP地址。这是您的UsbNcm IP。

• 在设备门户中

  1. 在您的设备上，使用HoloLens的WiFi地址打开设备门户。如果您不知道HoloLens的WiFi地址，可以使用语音命令“我的IP地址是什么？”
  2. 转到系统>网络
  3. 在页面最右侧的“IP Configuration”面板中，找到以“Description:UsbNcm Function”开头的部分
  4. 您的UsbNcm IP是“IPv4地址”行。您可以复制地址或单击地址-这是一个超链接，将使用UsbNcm IP重新打开设备门户。

• 在命令提示符中

  1. 在任何命令提示符中，导航到安装Windows 10 SDK的bin<SDK version>\x86文件夹，例如C:\Program Files（x86）\Windows Kits\10\bin\10.0.19041.0\x86。
  2. 键入“winappdeploycmd devices”并按Enter键。
  3. 在输出中，查找Model/Name列是HoloLens设备名称的条目，例如HoloLens-xxxxxx。UsbNcm IP位于此行的开头，将是一个自动专用IP地址，格式为169.254.x.x。复制此地址。

4. 如果您复制了UsbNcm IP，请从PC上的web浏览器转到https://，然后转到您的UsbNcmIP。

通过USB移动文件

您可以将文件从PC移动到HoloLens，无需任何其他设置。

1. 用USB线将电脑连接到HoloLens
2. 将文件拖到电脑\[Your_HoloLens_Device_Name]\内部存储器在桌面上
3. 打开开始菜单并选择所有应用程序>文件资源管理器在HoloLens上

连接到模拟器

您还可以将设备门户与模拟器一起使用。要连接到设备门户，请使用工具栏。选择此图标： 打开设备门户：在模拟器中打开HoloLens操作系统的Windows设备门户。

创建用户名和密码

设置对Windows设备门户的访问权限

第一次连接到HoloLens上的设备门户时，需要创建用户名和密码。

1. 在电脑的网络浏览器中，输入HoloLens的IP地址。将打开“设置”访问页面。
2. 选择或轻触请求pin并查看HoloLens显示屏以获取生成的PIN。
3. 在中输入PIN设备上显示的PIN文本框。
4. 输入用于连接到设备门户的用户名。它不需要是Microsoft帐户（MSA）名称或域名。
5. 输入密码并确认。密码长度必须至少为七个字符。它不需要是MSA或域密码。
6. 点击一对连接到HoloLens上的Windows设备门户。

如果您希望随时更改此用户名或密码，可以通过导航到：https://<YOUR_HOLOLENS_IP_ADDRESS>/devicepair.htm访问设备安全页面来重复此过程。

安全证书

如果您在浏览器中看到“证书错误”，可以通过创建与设备的信任关系来修复它。

每个HoloLens都会为其SSL连接生成一个自签名证书。默认情况下，您电脑的web浏览器不信任此证书，您可能会收到“证书错误”。您可以通过USB或您信任的Wi-Fi网络从HoloLens下载此证书并将其信任到PC上，从而安全地连接到您的设备。

1. 确保您使用的是安全网络（USB或您信任的Wi-Fi网络）。
2. 从设备门户的“安全”页面下载此设备的证书。
   • 导航至：https://<YOUR_HOLOLENS_IP_ADDRESS>/devicepair.htm
   • 打开“系统”>“首选项”的节点。
   • 向下滚动到设备安全，选择“下载此设备的证书”按钮。
3. 在电脑上的“受信任的根证书颁发机构”存储中安装证书。
   • 在Windows菜单中，键入：管理计算机证书并启动小程序。
   • 展开受信任的根证书颁发机构文件夹。
   • 选择证书文件夹。
   • 从操作菜单中，选择：所有任务>导入。。。
   • 使用从设备门户下载的证书文件完成证书导入向导。
4. 重新启动浏览器。

侧面加载应用程序

安装证书

1. 在Windows设备门户中，导航到应用程序管理器页面
2. 在部署应用程序部分中，选择安装证书
3. 在Select certificate file（.cer）used to sign an app package下，选择Choose file并浏览到与要侧载的应用程序包关联的证书
4. 选择安装开始安装

正在安装应用程序

1. 当你有从Visual Studio创建了应用程序包，您可以从生成的文件将其远程安装到设备上：

2. 在Windows设备门户中，导航到应用程序管理器页面
3. 在部署应用程序部分，选择本地存储
4. 在Select the application package下，选择Choose File并浏览到要侧载的应用程序包
5. 如果要随应用程序安装一起安装可选包或框架包，请选中相应的框，然后选择下一步:

6. 选择安装开始安装

安装完成后，返回所有应用程序页面并启动新安装的应用程序！

设备门户页面

主页

Microsoft HoloLens上的Windows设备门户主页

[注]设备门户中配置的设置应用于整个设备，并通过重新引导保持不变。设备门户供开发人员使用，而不是在已部署的应用程序中使用。

设备门户会话从主页开始。从主页左侧的导航栏访问其他页面。

页面顶部的工具栏提供对常用状态和功能的访问。

• 在线的：表示设备是否连接到Wi-Fi。
• 关机：关闭设备。
• 重新启动：循环接通设备电源。
• 安全：打开设备安全页面。
• 酷：表示设备的温度。
• A/C公司：指示设备是否已插入并充电。
• 帮助：打开REST接口文档页面。

主页显示以下信息：

• 设备状态：监视设备的运行状况并报告严重错误。
• Windows信息：显示HoloLens的名称和当前安装的Windows版本。
• 偏好部分包含以下设置：
  • IPD公司：设置瞳孔间距（IPD）-用户直视时瞳孔中心之间的距离，单位为毫米。设置立即生效。设置设备时会自动计算默认值。
  • 设备名称：为全息透镜指定名称。更改此值后，请重新启动设备以使其生效。单击后保存，将出现一个对话框，询问您是要立即重新启动设备还是稍后重新启动。
  • 睡眠设置：设置设备在插入电源和使用电池时进入睡眠状态之前的等待时间长度。

三维视图

Microsoft HoloLens上Windows设备门户中的3D视图页面

使用“三维视图”页面查看HoloLens如何解释周围环境。使用鼠标导航视图：

• 旋转：左键单击+鼠标；
• 平移：右键单击+鼠标；
• 缩放：鼠标滚动。
• 跟踪选项
  • 通过检查启用连续视觉跟踪强制视觉跟踪.
  • 暂停停止视觉跟踪。
• 查看选项：设置三维视图上的选项：
  • 跟踪：指示视觉跟踪是否处于活动状态。
  • 显示楼层：显示棋盘格楼板平面。
  • 显示平截头体：显示视锥。
  • 显示稳定平面：显示HoloLens用于稳定运动的平面。
  • 显示网格：显示表示您周围环境的空间贴图网格。
  • 显示空间定位：显示活动应用程序的空间锚定。选择“更新”按钮以获取并刷新锚点。
  • 显示详细信息：当手的位置、头部旋转四元数和设备原点向量实时更改时，显示它们。
  • 全屏按钮：以全屏模式显示3D视图。按ESC键退出全屏视图。
• 曲面重建：选择或点击更新以显示来自设备的最新空间映射网格。完成全程可能需要一些时间（最多几秒钟）。网格不会在三维视图中自动更新，必须手动选择更新从设备中获取最新的网格。选择保存将当前空间映射网格保存为PC上的obj文件。
• 空间锚点：选择“更新”以显示或更新活动应用程序的空间锚定。

地图管理器

地图管理器允许您跨设备共享地图，可用于为基于位置的娱乐客户设置共享体验。该工具允许您导入和导出系统地图和定位。

要访问地图管理器，请登录到设备门户并选择混合现实->地图管理器:

Microsoft HoloLens上Windows设备门户中的地图管理器页面

导出和导入地图

要导出地图，请选择导出系统图和锚点。这可能需要一段时间，因此请准备在导出地图时等待30-60秒。完成后，文件将在浏览器中下载。

要导入地图和定位，请选择上传地图文件和上传锚定文件分别选择一个已经导出的地图或锚点文件。上传的地图或定位文件可以来自任何其他HoloLens设备。

混合现实捕获

Microsoft HoloLens上Windows设备门户中的混合现实捕获页面

使用混合现实捕获页面保存HoloLens中的媒体流。

• 捕获设置：通过检查以下设置来控制捕获的媒体流：
  • 全息图：捕获视频流中的全息内容。全息图以单声道渲染，而不是立体渲染。
  • 光伏摄像机：从照片/摄像机捕获视频流。
  • 麦克风音频：从麦克风阵列捕获音频。
  • 应用程序音频：从当前运行的应用程序捕获音频。
  • 从摄影机渲染：将捕获内容与照片/摄像机的视角对齐，如果受正在运行的应用程序支持（仅HoloLens 2）。
  • 实时预览质量：选择实时预览的屏幕分辨率、帧速率和流速率。
• 音频设置（仅HoloLens 2）：
  • 音频媒体类别：选择处理麦克风时使用的类别。违约将包括一些环境，而通信应用背景噪音消除。
  • 应用程序音频增益：应用于应用程序音频音量的增益。
  • 麦克风音频增益：应用于麦克风音频音量的增益。
• 照片和视频设置（HoloLens 2，2004版或更高版本）：
  • 捕获配置文件：选择拍摄照片和视频时使用的配置文件。配置文件确定可用的分辨率和帧速率。
  • 照片分辨率：拍摄照片的分辨率。
  • 视频分辨率和帧速率：视频的分辨率和帧速率。
  • 视频稳定缓冲区：拍摄视频时使用的缓冲区大小。该值越高，对快速移动的补偿效果越好。
• 选择或轻触实时预览按钮显示捕获流。停止实时预览停止捕获流。
• 选择或轻触记录使用指定的设置开始录制mixed-reality流。停止录制结束录制并保存。
• 选择或轻触拍照从捕获流中获取静态图像。
• 选择或轻触恢复默认设置恢复音频、照片和视频设置的默认设置。
• 视频和照片：显示在设备上拍摄的视频和照片的列表。

此页面上的所有设置都适用于使用Windows设备门户拍摄的捕获。另外一些应用于系统MRC，包括开始菜单、硬件按钮、全局语音命令、Miracast和自定义MRC记录器。

性能跟踪

Microsoft HoloLens上Windows设备门户中的性能跟踪页面

捕获Windows性能记录器HoloLens的（WPR）痕迹。

• 可用配置文件：从下拉列表中选择WPR配置文件，然后选择或点击起点开始跟踪。
• 自定义配置文件：选择或点击浏览从电脑中选择WPR配置文件。选择或轻按上传并启动开始跟踪。

要停止跟踪，请选择停止链接。在跟踪文件完成下载之前，请停留在此页面。

捕获的ETL文件可以在中打开进行分析Windows性能分析器.

有关性能跟踪的更深入了解，请参阅HoloLens性能跟踪如何.

过程

Microsoft HoloLens上Windows设备门户中的进程页面

显示有关当前正在运行的进程的详细信息。这包括应用程序和系统进程。

系统性能

Microsoft HoloLens上Windows设备门户中的“系统性能”页面

显示系统诊断信息的实时图形，如电源使用、帧速率和CPU负载。

以下是可用的指标：

• SoC电源：瞬时系统-芯片功耗，一分钟内平均值
• 系统电源：瞬时系统功耗，一分钟内平均值
• 帧速率：每秒帧数、每秒错过的VBlank数和连续错过的VBank数
• 通用分组：GPU引擎使用率，占可用总量的百分比
• 中央处理器：可用总量的百分比
• 输入/输出：读取和写入
• 网络：接收和发送
• 存储器：总计、在用、已提交、分页和未分页

应用程序

Microsoft HoloLens上Windows设备门户中的应用程序页面

管理HoloLens上安装的应用程序。

• 已安装的应用程序：删除并启动应用。
• 运行应用程序：列出当前正在运行的应用。
• 安装应用程序：从计算机/网络上的文件夹中选择要安装的应用程序包。
• 附属国：为要安装的应用程序添加依赖项。
• 部署：将选定的应用程序+依赖项部署到HoloLens。

应用程序崩溃转储

Microsoft HoloLens上Windows设备门户中的应用程序崩溃转储页面

此页面允许您收集并行加载应用的崩溃转储。检查已启用崩溃转储要为其收集崩溃转储的每个应用程序的复选框。返回此页面以收集崩溃转储。转储文件可以是在Visual Studio中打开以进行调试.

文件资源管理器

Microsoft HoloLens上Windows设备门户中的文件资源管理器页面

使用文件资源管理器浏览、上传和下载文件。您可以使用Documents文件夹、Pictures文件夹以及从Visual Studio或设备门户部署的应用程序的本地存储文件夹中的文件。

Kiosk模式

检查在kiosk模式下设置HoloLens有关通过Windows设备门户启用信息亭模式的最新说明，请参阅Windows IT Pro Center中的文章。

登录中

Microsoft HoloLens上Windows设备门户中的日志记录页面

在HoloLens上管理Windows（ETW）的实时事件跟踪。

检查隐藏提供程序以显示事件仅列出。

• 注册提供商：选择ETW提供程序和跟踪级别。跟踪级别是以下值之一：
  1. 异常退出或终止
  2. 严重错误
  3. 警告
  4. 无错误警告

选择或轻触启用开始跟踪。提供程序将添加到启用的提供程序下拉列表。

• 自定义提供程序：选择自定义ETW提供程序和跟踪级别。通过GUID标识提供程序。不要在GUID中包含括号。
• 启用的提供程序：列出已启用的提供程序。从下拉列表中选择提供商，然后单击或轻按禁用停止跟踪。点击或点击全部停止暂停所有跟踪。
• 提供商历史记录：显示当前会话期间启用的ETW提供程序。点击或点击启用以激活已禁用的提供程序。点击或点击清除清理历史。
• 事件：以表格格式列出所选提供程序中的ETW事件。此表实时更新。在表下面，单击清除按钮从表中删除所有ETW事件。这不会禁用任何提供程序。您可以单击保存到文件以将当前收集的ETW事件导出到本地CSV文件。
• 过滤器：允许您按ID、关键字、级别、提供程序名称、任务名称或文本筛选收集的ETW事件。您可以将多个条件组合在一起：
  1. 对于应用于同一属性的条件，将显示可以满足其中任何一个条件的事件。
  2. 对于应用于不同属性的条件，事件必须满足所有条件

例如，您可以指定条件（任务名称包含“Foo”或“Bar”）和（文本包含“error”或“warning”）

模拟

Microsoft HoloLens上Windows设备门户中的模拟页面

允许您记录和回放输入数据以进行测试。

• 捕获室：用于下载包含用户周围环境的空间映射网格的模拟房间文件。命名房间，然后单击捕获将数据保存为电脑上的.xef文件。此文件可以加载到HoloLens模拟器中。
• 记录：检查要录制的流，命名录制，然后单击或轻按记录开始重新编码。使用HoloLens执行操作，然后单击停止将数据保存为电脑上的.xef文件。此文件可以加载到HoloLens模拟器或设备上。

  注释

  录制功能目前仅在第一代HoloLens上可用。HoloLens2尚不支持录制，但支持播放现有录制。

• 播放：单击或轻触上传录音从电脑中选择xef文件并将数据发送到HoloLens。
• 控制模式：选择违约或模拟从下拉列表中单击或轻触设置按钮选择HoloLens上的模式。选择“模拟”将禁用全息透镜上的真实传感器，而使用上传的模拟数据。如果切换到“Simulation”（模拟），HoloLens在切换回“Default”（默认）之前不会对真实用户做出响应。

网络

Microsoft HoloLens上Windows设备门户中的网络页面

管理HoloLens上的Wi-Fi连接。

• WiFi适配器：使用下拉控件选择Wi-Fi适配器和配置文件。点击或点击连接使用所选适配器。
• 可用网络：列出HoloLens可以连接的Wi-Fi网络。单击或轻按刷新更新列表。
• IP配置：显示网络连接的IP地址和其他详细信息。

PowerThermalSDK测试

Microsoft HoloLens上Windows设备门户中的PowerThermalSDK测试页

用于PowerThermalNotification SDK。请参见管理电源和热量.

使用此页面可以监视和控制SDK使用的缓解级别和热得分。该页面还提供了哪些外围设备的缓解措施被活动应用程序抑制的详细信息。

虚拟输入

Microsoft HoloLens上Windows设备门户中的虚拟输入页面

将键盘输入从远程机器发送到HoloLens。

单击或轻触下的区域虚拟键盘以启用向HoloLens发送按键。键入输入文本文本框并单击或轻触发送将按键发送到活动应用程序。

设备门户REST API

设备门户中的所有内容都建立在REST API您可以选择使用它来访问数据并以编程方式控制设备。

故障排除

如何修复“这里很孤独”的消息

1. 选择重置布局从左上角的菜单：

2. 点击重置布局在重置工作区标题。门户页面将自动刷新并显示您的内容。