使用 Windows 设备门户Using the Windows Device Portal

功能FeatureHoloLens(第一代)HoloLens (1st gen)HoloLens 2HoloLens 2
Windows 设备门户Windows Device Portal ✔️✔️ ✔️✔️

使用适用于 HoloLens 的 Windows 设备门户可以通过 Wi-Fi 或 USB 远程配置和管理设备。The Windows Device Portal for HoloLens lets you configure and manage your device remotely over Wi-Fi or USB. Device Portal 是 HoloLens 上的 Web 服务器,你可以从电脑上的 Web 浏览器连接到它。The Device Portal is a web server on your HoloLens that you can connect to from a web browser on your PC. 设备门户包含许多工具,可帮助你管理 HoloLens 以及调试和优化应用。The Device Portal includes many tools that will help you manage your HoloLens and debug and optimize your apps.

本文档专门介绍适用于 HoloLens 的 Windows 设备门户。This documentation is specifically about the Windows Device Portal for HoloLens. 若要使用适用于桌面(包括 Windows Mixed Reality)的 Windows 设备门户,请参阅 Windows 设备门户概述To use the Windows Device portal for desktop (including for Windows Mixed Reality), see Windows Device Portal overview

将 HoloLens 设置为使用 Windows 设备门户Setting up HoloLens to use Windows Device Portal

  1. 打开 HoloLens 的电源,然后戴上设备。Power on your HoloLens and put on the device.
  2. 针对 HoloLens2 执行开始手势,或者在 HoloLens(第一代)上执行开花手势,以启动主菜单。Perform the Start gesture for HoloLens2 or Bloom on HoloLens (1st Gen) to launch the main menu.
  3. 凝视“设置”磁贴,然后在 HoloLens(第一代)上执行隔空敲击手势,或者在 HoloLens 2 上通过触摸或手部射线选择该磁贴。Gaze at the Settings tile and perform the air-tap gesture on HoloLens (1st Gen) or select it on HoloLens 2 by touching it or using a Hand ray.
  4. 选择“更新”菜单项。Select the Update menu item.
  5. 选择“面向开发人员”菜单项。Select the For developers menu item.
  6. 启用“开发人员模式”。Enable Developer Mode.

重要

如果你使用的是多用户而不是管理员,则进入开发人员模式的功能可能灰显。请确保你是设备上的管理员If you're in multi-user and not an admin, the ability to enter Developer Mode may be grayed out. Please ensure that you are an admin on the device.

  1. 向下滚动并启用“设备门户”。Scroll down and enable Device Portal.
  2. 如果要设置 Windows 设备门户以便可以通过 USB 或 Wi-Fi 将应用部署到此 HoloLens,请单击“配对”以生成配对 PINIf you are setting up Windows Device Portal so you can deploy apps to this HoloLens over USB or Wi-Fi, click Pair to generate a pairing PIN. 在首次部署期间,请在“PIN”弹出窗口中保持打开“设置”应用,直到在 Visual Studio 中输入了 PIN 才将它关闭。Leave the Settings app at the PIN popup until you enter the PIN into Visual Studio during your first deployment.

在 Windows Holographic 的“设置”应用中启用开发人员模式

通过 Wi-Fi 进行连接Connecting over Wi-Fi

  1. 将 HoloLens 连接到 Wi-FiConnect your HoloLens to Wi-Fi.
  2. 通过以下任一方法查找设备的 IP 地址:Look up your device's IP address by either:
    • 依次转到“设置”>“网络和 Internet”>“Wi-Fi”>“高级选项”。Going to Settings > Network & Internet > Wi-Fi > Advanced Options.
    • 转到“设置”>“网络和 Internet”,然后选择“硬件属性” 。Going to Settings > Network & Internet and selecting Hardware properties.

HoloLens 2 设置

  1. 在电脑上的 Web 浏览器中,转到 https://<HOLOLENS IP 地址>From a web browser on your PC, go to https://<YOUR_HOLOLENS_IP_ADDRESS>
    • 浏览器中将显示以下消息:“此网站的安全证书有问题。”The browser will display the following message: "There's a problem with this website's security certificate". 由于颁发给 Device Portal 的证书是测试证书,因此会显示上述消息。This happens because the certificate which is issued to the Device Portal is a test certificate. 你可以暂时忽略此证书错误并继续。You can ignore this certificate error for now and proceed.

通过 USB 进行连接Connecting over USB

  1. 安装所需的工具,确保电脑上安装了带有 Windows 10 开发人员工具的 Visual Studio,以启用 USB 连接。Install the tools to make sure you have Visual Studio with the Windows 10 developer tools installed on your PC to enable USB connectivity.

重要

如果在 USB 连接方面遇到问题,请再次检查 USB 设备连接可选组件是否已作为 Visual Studio工具包的一部分安装。If you're having issues with USB connectivity double check that the USB Device Connectivity optional component is installed as part of your Visual Studio tool package.

  1. 使用适用于 HoloLens(第一代)的 micro-USB 数据线或适用于 HoloLens 2 的 USB-C 数据线将 HoloLens 连接到电脑。Connect your HoloLens to your PC with a micro-USB cable for HoloLens (1st Gen) or USB-C for HoloLens 2.
  2. 在电脑上的 Web 浏览器中,转到 https://127.0.0.1:10080From a web browser on your PC, go to https://127.0.0.1:10080.

通过 USB 移动文件Moving files over USB

无需进行任何其他设置,即可将文件从电脑移动到 HoloLens。You can move files from your PC to your HoloLens without any additional setup.

  1. 使用 USB 线将电脑连接到 HoloLensConnect your PC to your HoloLens with a USB cord
  2. 将文件拖动到桌面上的“PC\[Your_HoloLens_Device_Name]\Internal Storage”中Drag your files into PC\[Your_HoloLens_Device_Name]\Internal Storage on your desktop
  3. 打开“开始”菜单,然后在 HoloLens 上选择“所有应用”>“文件资源管理器” Open the Start Menu and select All apps > File Explorer on your HoloLens

备注

可能需要选择面板左侧的“此设备”,才能从“最近使用”进行导航以查找文件。You may need to select This device on the left side of the panel to navigate away from "Recently used" to locate your files.

连接到仿真器Connecting to an emulator

也可以将 Device Portal 与仿真器结合使用。You can also use the Device Portal with your emulator. 若要连接到设备门户,请使用工具栏To connect to the Device Portal, use the toolbar. 单击此图标:“打开设备门户”图标 打开设备门户:在仿真器中打开 HoloLens OS 的 Windows 设备门户。Click on this icon: Open Device Portal icon Open Device Portal: Open the Windows Device Portal for the HoloLens OS in the emulator.

创建用户名和密码Creating a Username and Password

设置对 Windows 设备门户的访问Set up access to Windows Device Portal
设置对 Windows 设备门户的访问Set up access to Windows Device Portal

首次连接到 HoloLens 上的 Device Portal 时,需要创建用户名和密码。The first time you connect to the Device Portal on your HoloLens, you will need to create a username and password.

  1. 在电脑上的 Web 浏览器中,输入 HoloLens 的 IP 地址。In a web browser on your PC, enter the IP address of the HoloLens. 将打开“设置访问”页面。The Set up access page opens.
  2. 单击或敲击“请求 PIN”,然后查看 HoloLens 屏幕以获取生成的 PIN。Click or tap Request pin and look at the HoloLens display to get the generated PIN.
  3. 在“设备上显示的 PIN”文本框中输入该 PIN。Enter the PIN in the PIN displayed on your device textbox.
  4. 输入将用于连接到 Device Portal 的用户名。Enter the user name you will use to connect to the Device Portal. 无需使用 Microsoft 帐户 (MSA) 名称或域名作为用户名。It doesn't need to be a Microsoft Account (MSA) name or a domain name.
  5. 输入密码并进行确认。Enter a password and confirm it. 密码长度必须至少为七个字符。The password must be at least seven characters in length. 无需使用 MSA 密码或域密码作为密码。It doesn't need to be an MSA or domain password.
  6. 单击“配对”以连接到 HoloLens 上的 Windows 设备门户。Click Pair to connect to Windows Device Portal on the HoloLens.

今后如果你想要更改此用户名和密码,可以导航到 https://<HOLOLENS IP 地址>/devicepair.htm 来访问设备安全性页,然后重复上述过程。If you wish to change this username or password at any time, you can repeat this process by visiting the device security page by navigating to: https://<YOUR_HOLOLENS_IP_ADDRESS>/devicepair.htm.

安全证书Security certificate

如果在浏览器中看到“证书错误”,可以通过创建与该设备的信任关系来修复该错误。If you see a "certificate error" in your browser, you can fix it by creating a trust relationship with the device.

每个 HoloLens 会生成唯一的自签名证书以供其 SSL 连接使用。Each HoloLens generates a unique self-signed certificate for its SSL connection. 默认情况下,此证书不受电脑的 Web 浏览器信任,因此你可能会看到“证书错误”。By default, this certificate is not trusted by your PC's web browser and you may get a "certificate error". 通过从你的 HoloLens 下载此证书(借助 USB 或信任的 WLAN 网络)并在你的电脑上信任该证书,可以安全地连接到设备。By downloading this certificate from your HoloLens (over USB or a Wi-Fi network you trust) and trusting it on your PC, you can securely connect to your device.

  1. 确保在安全网络(USB 或信任的 Wi-Fi 网络)中操作。Make sure you are on a secure network (USB or a Wi-Fi network you trust).
  2. 从设备门户上的“安全性”页下载此设备的证书。Download this device's certificate from the "Security" page on the Device Portal.
    • 导航到 https://<HOLOLENS IP 地址>/devicepair.htmNavigate to: https://<YOUR_HOLOLENS_IP_ADDRESS>/devicepair.htm
    • 打开“系统”>“首选项”对应的节点。Open the node for System > Preferences.
    • 向下滚动到“设备安全性”,然后单击“下载此设备的证书”按钮。Scroll down to Device Security, click the "Download this device's certificate" button.
  3. 在电脑上安装“受信任的根证书颁发机构”存储中的证书。Install the certificate in the "Trusted Root Certification Authorities" store on your PC.
    • 在 Windows 菜单中键入:管理计算机证书并启动小程序。From the Windows menu, type: Manage Computer Certificates and start the applet.
    • 展开“受信任的根证书颁发机构”文件夹。Expand the Trusted Root Certification Authority folder.
    • 单击“证书”文件夹。Click the Certificates folder.
    • 在“操作”菜单中选择:“所有任务”>“导入...”From the Action menu, select: All Tasks > Import...
    • 使用从 Device Portal 下载的证书文件,完成“证书导入向导”。Complete the Certificate Import Wizard, using the certificate file you downloaded from the Device Portal.
  4. 重新启动浏览器。Restart the browser.

备注

此证书仅在该设备上受信任,如果刷写了设备,用户必须再次执行此过程。This certificate will only be trusted for the device and the user will have to go through the process again if the device is flashed.

Device Portal 页面Device Portal Pages

主页Home

Microsoft HoloLens 上的 Windows 设备门户主页Windows Device Portal home page on Microsoft HoloLens
Microsoft HoloLens 上的 Windows 设备门户主页Windows Device Portal home page on Microsoft HoloLens

Device Portal 会话从主页开始。Your Device Portal session starts at the Home page. 可从主页的左侧导航栏访问其他页面。Access other pages from the navigation bar along the left side of the home page.

主页顶部的工具栏提供对常用状态和功能的访问。The toolbar at the top of the page provides access to commonly used status and features.

  • 联机:指示设备是否已连接到 Wi-Fi。Online: Indicates whether the device is connected to Wi-Fi.
  • 关机:关闭设备。Shutdown: Turns off the device.
  • 重启:关闭再打开设备的电源。Restart: Cycles power on the device.
  • 安全:打开“设备安全性”页。Security: Opens the Device Security page.
  • :指示设备的温度。Cool: Indicates the temperature of the device.
  • 交流电源:指示设备是否已接上电源并正在充电。A/C: Indicates whether the device is plugged in and charging.
  • 帮助:打开 REST 接口文档页。Help: Opens the REST interface documentation page.

主页将显示以下信息:The home page shows the following info:

  • 设备状态: 监视设备的运行状况并报告严重错误。Device Status: monitors the health of your device and reports critical errors.
  • Windows 信息: 显示 HoloLens 的名称,以及当前安装的 Windows 版本。Windows information: shows the name of the HoloLens and the currently installed version of Windows.
  • 首选项部分包含以下设置:Preferences section contains the following settings:
    • IPD:设置瞳孔间距 (IPD),它是在用户直视前方时两个瞳孔中心之间的距离,以毫米为单位。IPD: Sets the interpupillary distance (IPD), which is the distance, in millimeters, between the center of the user's pupils when looking straight ahead. 该设置将立即生效。The setting takes effect immediately. 在设置你的设备时,会自动计算该默认值。The default value was calculated automatically when you set up your device.
    • 设备名称:为 HoloLens 指定一个名称。Device name: Assign a name to the HoloLens. 更改此值后,必须重新启动设备才能使该值生效。You must reboot the device after changing this value for it to take effect. 单击“保存”后,对话框将询问是要立即重新启动还是稍后重新启动设备。After clicking Save, a dialog will ask if you want to reboot the device immediately or reboot later.
    • 睡眠设置:设置当设备已接上电源并使用电池时进入睡眠状态之前要等待的时长。Sleep settings: Sets the length of time to wait before the device goes to sleep when it's plugged in and when it's on battery.

3D 视图3D View

Microsoft HoloLens 上 Windows 设备门户中的“3D 视图”页3D View page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“3D 视图”页3D View page in Windows Device Portal on Microsoft HoloLens

使用“3D 视图”页面可查看 HoloLens 感知周围环境的方式。Use the 3D View page to see how HoloLens interprets your surroundings. 使用鼠标即可导览该视图:Navigate the view by using the mouse:

  • 旋转:单击左键并移动鼠标;Rotate: left click + mouse;
  • 平移:单击右键并移动鼠标;Pan: right click + mouse;
  • 缩放:滑动鼠标滚轮。Zoom: mouse scroll.
  • 跟踪选项Tracking options
    • 通过选中“强制视觉跟踪”可打开持续视觉跟踪。Turn on continuous visual tracking by checking Force visual tracking.
    • “暂停”会停止视觉跟踪。Pause stops visual tracking.
  • 视图选项:设置 3D 视图中的选项:View options: Set options on the 3D view:
    • 跟踪:指示视觉跟踪是否处于活动状态。Tracking: Indicates whether visual tracking is active.
    • 显示地面:显示方格形式的地平面。Show floor: Displays a checkered floor plane.
    • 显示锥体:显示视锥。Show frustum: Displays the view frustum.
    • 显示防抖动平面:显示 HoloLens 用于稳定动作的平面。Show stabilization plane: Displays the plane that HoloLens uses for stabilizing motion.
    • 显示网格:显示代表周围环境的空间映射网格。Show mesh: Displays the spatial mapping mesh that represents your surroundings.
    • 显示空间定位点:显示活动应用的空间定位点。Show spatial anchors: Displays spatial anchors for the active app. 必须单击“更新”按钮才能获取和刷新定位点。You must click the Update button to get and refresh the anchors.
    • 显示细节:显示手的位置、头部旋转四元数,以及设备原点矢量的实时变化。Show details: Displays hand positions, head rotation quaternions, and the device origin vector as they change in real time.
    • 全屏按钮:以全屏模式显示 3D 视图。Full screen button: Shows the 3D View in full screen mode. 按 ESC 键可退出全屏视图。Press ESC to exit full screen view.
  • 图面重构:单击或敲击“更新”可显示设备的最新空间映射网格。Surface reconstruction: Click or tap Update to display the latest spatial mapping mesh from the device. 完成整个过程可能需要一些时间(但最多只需几秒钟)。A full pass may take some time to complete (up to a few seconds). 在 3D 视图中,网格不会自动更新,必须手动单击“更新”才能获取设备的最新网格。The mesh does not update automatically in the 3D view, and you must manually click Update to get the latest mesh from the device. 单击“保存”可在电脑上将当前的空间映射网格保存为 obj 文件。Click Save to save the current spatial mapping mesh as an obj file on your PC.
  • 空间定位点:单击“更新”可显示或更新活动应用的空间定位点。Spatial anchors: Click Update to display or update the spatial anchors for the active app.

地图管理器Map Manager

通过地图管理器,可跨设备共享地图,这可用于为基于位置的娱乐客户设置共享体验。Map Manager allows you to share maps across devices, which can be used to setup shared experiences for Location Based Entertainment customers. 该工具允许你导入和导出系统地图和定位点。The tool allows you to import and export system maps and anchors.

若要访问地图管理器,请登录设备门户并选择“混合现实”->“地图管理器”:To access the Map Manager, log into the Device Portal and select Mixed Reality -> Map Manager:

Windows 设备门户中的“地图管理器”页 Microsoft HoloLens 上 Windows 设备门户中的“地图管理器”页**Map manager page in Windows Device Portal Map Manager page in Windows Device Portal on Microsoft HoloLens

导出和导入地图Exporting and importing maps

若要导出地图,请单击“导出系统地图和定位点”。To export maps, click Export System Map & Anchors. 此操作可能需要一段时间,所以在导出地图时,请准备好等待 30-60 秒。This could take a while so be prepared to wait for 30-60 seconds while the map is exported. 完成后,文件将下载到浏览器中。Once it’s complete, the file will be downloaded in your browser.

若要导入地图和定位点,请分别单击“上传地图文件”和“上传定位点文件”,然后选择已经导出的地图或定位点文件 。To import maps and anchors, click Upload a map file and Upload an anchor file respectively and select a map or anchor file that you've already exported. 上传的地图或定位点文件可能来自你的设备或任何其他 HoloLens 设备。The uploaded map or anchor file can come from your or any other HoloLens device.

备注

在 HoloLens 上,还可以导入和导出空间映射数据库。On HoloLens, it's also possible to import and export the spatial mapping data base. 然而,这在非 HoloLens 设备上不起作用。However, this doesn't work on non-HoloLens devices.

混合现实捕获Mixed Reality Capture

Microsoft HoloLens 上 Windows 设备门户中的“混合现实捕获”页Mixed Reality Capture page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“混合现实捕获”页Mixed Reality Capture page in Windows Device Portal on Microsoft HoloLens

使用“混合现实捕获”页面可保存 HoloLens 中的媒体流。Use the Mixed Reality Capture page to save media streams from the HoloLens.

  • 捕获设置:通过检查以下设置来控制捕获的媒体流:Capture Settings: Control the media streams that are captured by checking the following settings:
    • 全息影像:捕获视频流中的全息内容。Holograms: Captures the holographic content in the video stream. 呈现全息图时使用的是单声道,而不是立体声。Holograms are rendered in mono, not stereo.
    • PV 相机:捕获照片/视频相机中的视频流。PV camera: Captures the video stream from the photo/video camera.
    • 麦克风音频:捕获麦克风阵列中的音频。Mic Audio: Captures audio from the microphone array.
    • 应用音频:捕获当前正在运行的应用中的音频。App Audio: Captures audio from the currently running app.
    • 从相机渲染:从照片/视频相机的角度对齐捕获内容,前提是正在运行的应用支持此功能(仅限 HoloLens 2)。Render from Camera: Aligns the capture to be from the perspective of the photo/video camera, if supported by the running app (HoloLens 2 only).
    • 实时预览质量:选择用于实时预览的屏幕分辨率、帧速率和流处理速率。Live preview quality: Select the screen resolution, frame rate, and streaming rate for the live preview.
  • 音频设置(仅限 HoloLens 2):Audio Settings (HoloLens 2 only):
    • 音频媒介类别:选择在处理麦克风时使用的类别。Audio Media Category: Select the category is used when processing the microphone. “默认值”将包括某些环境,这些环境中的“通信”会应用背景噪音消除。 Default will include some of the environment whereas Communications applies background noise cancellation.
    • 应用音频增益:应用于应用音频音量的增益。App Audio Gain: The gain applied to app audio's volume.
    • 麦克风音频增益:应用于麦克风音频音量的增益。Mic Audio Gain: The gain applied to mic audio's volume.
  • 照片和视频设置(HoloLens 2,版本 2004 或更高版本):Photo and Video Settings (HoloLens 2, version 2004 or later):
    • 捕获配置文件:选择拍摄照片和视频时使用的配置文件。Capture Profile: Select the profile used when taking photos and videos. 配置文件决定可用的分辨率和帧速率。The profile determines which resolutions and frame-rates are available.
    • 照片分辨率:拍摄照片时使用的分辨率。Photo Resolution: The resolution the photo will be taken with.
    • 视频分辨率和帧速率:拍摄视频时使用的分辨率和帧速率。Video Resolution and Frame-rate: The resolution and frame-rate the video will be taken with.
    • 视频稳定缓冲区:拍摄视频时使用的缓冲区大小。Video Stabilization Buffer: The buffer size used when taking a video. 此值越大,弥补快速移动的效果越好。The higher the value, the better it can compensate for quick movements.
  • 单击或敲击“实时预览”按钮可显示捕获流。Click or tap the Live preview button to show the capture stream. “停止实时预览”会停止捕获流。Stop live preview stops the capture stream.
  • 单击或敲击“录制”可使用指定的设置开始录制混合现实流。Click or tap Record to start recording the mixed-reality stream, using the specified settings. “停止录制”会结束录制,并保存录制内容。Stop recording ends the recording and saves it.
  • 单击或敲击“拍摄照片”可从捕获流中捕获静止图像。Click or tap Take photo to take a still image from the capture stream.
  • 单击或点击“还原默认设置”,可还原音频、照片和视频设置的默认设置。Click or tap Restore Default Settings to restore the default settings for audio, photo, and video settings.
  • 视频和照片:显示在设备上捕获的视频和照片列表。Videos and photos: Shows a list of video and photo captures taken on the device.

此页面上的所有设置都适用于使用 Windows 设备门户完成的捕获,但一些设置还适用于系统 MRC(“开始”菜单、硬件按钮、全局语音命令、Miracast)和自定义 MRC 记录器。All settings on this page apply to captures taken using Windows Device Portal, but some additionally apply to System MRC (start menu, hardware buttons, global voice commands, Miracast) and to custom MRC Recorders.

设置Setting 适用于系统 MRCApplies to System MRC 适用于自定义 MRC 记录器Applies to Custom MRC Recorders
全息影像Holograms No No
PV 摄像头PV camera No No
麦克风音频Mic Audio No No
应用音频App Audio No No
从摄像头渲染Render from Camera Yes 是(可以重写)Yes (can be overridden)
实时预览质量Live preview quality No No
音频媒介类别Audio Media Category Yes No
应用音频增益App Audio Gain Yes 是(可以重写)Yes (can be overridden)
麦克风音频增益Mic Audio Gain Yes 是(可以重写)Yes (can be overridden)
捕获配置文件Capture Profile Yes No
照片分辨率Photo Resolution Yes No
视频分辨率和帧速率Video Resolution and Frame-rate Yes No
视频稳定缓冲区Video Stabilization Buffer Yes 是(可以重写)Yes (can be overridden)

备注

同步 MRC 存在限制There are limitations to simultaneous MRC:

  • 如果当 Windows 设备门户正在录制视频时某个应用尝试访问照片/视频相机,则视频录制将会停止。If an app tries to access the photo/video camera while Windows Device Portal is recording a video, the video recording will stop.
    • 如果应用以 SharedReadOnly 模式访问照片/视频相机,HoloLens 2 将不会停止视频录制。HoloLens 2 will not stop recording video if the app accesses the photo/video camera with SharedReadOnly mode.
  • 如果应用正在使用照片/视频相机,则 Windows 设备门户可以拍摄照片或录制视频。If an app is actively using the photo/video camera, Windows Device Portal is able to take a photo or record a video.
  • 实时传送视频流:Live streaming:
    • 从 Windows 设备门户实时传送视频流时,HoloLens(第一代)会阻止应用访问照片/视频相机。HoloLens (1st gen) prevents an app from accessing the photo/video camera while live streaming from Windows Device Portal.
    • 如果应用正在使用照片/视频相机,则 HoloLens(第一代)将无法实时传送视频流。HoloLens (1st gen) will fail to live stream if an app is actively using the photo/video camera.
    • 当应用尝试以 ExclusiveControl 模式访问照片/视频相机时,HoloLens 2 会自动停止实时传送视频流。HoloLens 2 automatically stops live streaming when an app tries to access the photo/video camera in ExclusiveControl mode.
    • 当应用正在使用 PV 相机时,HoloLens 2 可以启动实时传送视频流。HoloLens 2 is able to start a live stream while an app is actively using the PV camera.

性能跟踪Performance Tracing

Microsoft HoloLens 上 Windows 设备门户中的“性能跟踪”页Performance Tracing page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“性能跟踪”页Performance Tracing page in Windows Device Portal on Microsoft HoloLens

从 HoloLens 中捕获 Windows Performance Recorder (WPR) 跟踪。Capture Windows Performance Recorder (WPR) traces from your HoloLens.

  • 可用配置文件:从下拉列表中选择 WPR 配置文件,然后单击或敲击“开始”以开始跟踪。Available profiles: Select the WPR profile from the dropdown, and click or tap Start to start tracing.
  • 自定义配置文件:单击或敲击“浏览”以从电脑中选择 WPR 配置文件。Custom profiles: Click or tap Browse to choose a WPR profile from your PC. 单击或敲击“上传并启动”以开始跟踪。Click or tap Upload and start to start tracing.

若要停止跟踪,请单击“停止”链接。To stop the trace, click the stop link. 请保持打开此页,直到跟踪文件完成下载。Stay on this page until the trace file has completed downloading.

可以打开捕获的 ETL 文件以供在 Windows Performance Analyzer 中进行分析。Captured ETL files can be opened for analysis in Windows Performance Analyzer.

进程Processes

Microsoft HoloLens 上 Windows 设备门户中的“进程”页Processes page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“进程”页Processes page in Windows Device Portal on Microsoft HoloLens

显示有关当前正在运行的进程的详细信息。Shows details about currently running processes. 这包括应用和系统进程。This includes both apps and system processes.

系统性能System Performance

Microsoft HoloLens 上 Windows 设备门户中的“系统性能”页System Performance page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“系统性能”页System Performance page in Windows Device Portal on Microsoft HoloLens

显示系统诊断信息的实时图形,如电源使用情况、帧速率和 CPU 负载。Shows real-time graphs of system diagnostic info, like power usage, frame rate, and CPU load.

可用的指标如下所示:These are the available metrics:

  • SoC 电源:片上系统的瞬时用电量,为一分钟平均值SoC power: Instantaneous system-on-chip power utilization, averaged over one minute
  • 系统电源:系统的瞬时用电量,为一分钟平均值System power: Instantaneous system power utilization, averaged over one minute
  • 帧速率:每秒帧数、每秒丢失的垂直消隐数和连续丢失的垂直消隐数Frame rate: Frames per second, missed VBlanks per second, and consecutive missed VBlanks
  • GPU:GPU 引擎利用率、总可用量的百分比GPU: GPU engine utilization, percent of total available
  • CPU:总可用量的百分比CPU: percent of total available
  • I/O:读取和写入次数I/O: Reads and writes
  • 网络:接收和发送数据量Network: Received and sent
  • 内存:总计、已用、已提交、已分页和未分页Memory: Total, in use, committed, paged, and non-paged

“应用”Apps

Microsoft HoloLens 上 Windows 设备门户中的“应用”页Apps page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“应用”页Apps page in Windows Device Portal on Microsoft HoloLens

管理 HoloLens 上安装的应用。Manages the apps that are installed on the HoloLens.

  • 已安装的应用:删除和启动应用。Installed apps: Remove and start apps.
  • 正在运行的应用:列出当前正在运行的应用。Running apps: Lists apps that are running currently.
  • 安装应用:从计算机/网络上的文件夹中选择应用包进行安装。Install app: Select app packages for installation from a folder on your computer/network.
  • 依赖项:为要安装的应用添加依赖项。Dependency: Add dependencies for the app you are going to install.
  • 部署:将所选应用和依赖项部署到 HoloLens。Deploy: Deploy the selected app + dependencies to the HoloLens.

应用故障转储App Crash Dumps

Microsoft HoloLens 上 Windows 设备门户中的“应用故障转储”页App Crash Dumps page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“应用故障转储”页App Crash Dumps page in Windows Device Portal on Microsoft HoloLens

此页面允许你收集旁加载应用的故障转储。This page allows you to collect crash dumps for your side-loaded apps. 对于要收集其故障转储的每个应用,请选中对应的“已启用故障转储”复选框。Check the Crash Dumps Enabled checkbox for each app for which you want to collect crash dumps. 返回到此页面可收集故障转储。Return to this page to collect crash dumps. 在 Visual Studio 中打开转储文件进行调试Dump files can be opened in Visual Studio for debugging.

文件资源浏览器File Explorer

Microsoft HoloLens 上 Windows 设备门户中的“文件资源浏览器”页File Explorer page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“文件资源浏览器”页File Explorer page in Windows Device Portal on Microsoft HoloLens

使用文件资源管理器可以浏览、上传和下载文件。Use the file explorer to browse, upload, and download files. 对于从 Visual Studio 或设备门户部署的应用,可以处理“文档”文件夹、“图片”文件夹和本地存储文件夹中的文件。You can work with files in the Documents folder, Pictures folder, and in the local storage folders for apps that you deployed from Visual Studio or the Device Portal.

展台模式Kiosk Mode

备注

展台模式仅适用于 Microsoft HoloLens Commercial SuiteKiosk mode is only available with the Microsoft HoloLens Commercial Suite.

Microsoft HoloLens 上 Windows 设备门户中的“展台模式”页

有关如何通过 Windows 设备门户启用展台模式的最新说明,请查看 Windows IT 专业人员中心内的在展台模式下设置 HoloLens 一文。Check the Set up HoloLens in kiosk mode article in Windows IT Pro Center for up-to-date instructions on enabling kiosk mode via Windows Device Portal.

日志记录Logging

Microsoft HoloLens 上 Windows 设备门户中的“日志记录”页Logging page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“日志记录”页Logging page in Windows Device Portal on Microsoft HoloLens

管理 HoloLens 上的实时 Windows 事件跟踪 (ETW)。Manages realtime Event Tracing for Windows (ETW) on the HoloLens.

选中“隐藏提供程序”以仅显示“事件”列表。 Check Hide providers to show the Events list only.

  • 已注册的提供程序:选择 ETW 提供程序和跟踪级别。Registered providers: Select the ETW provider and the tracing level. 跟踪级别是以下值之一:Tracing level is one of these values:
    1. 异常退出或终止Abnormal exit or termination
    2. 严重错误Severe errors
    3. 警告Warnings
    4. 非错误警告Non-error warnings

单击或敲击“启用”以开始跟踪。Click or tap Enable to start tracing. 提供程序将添加到“已启用的提供程序”下拉列表。The provider is added to the Enabled Providers dropdown.

  • 自定义提供程序:选择自定义 ETW 提供程序和跟踪级别。Custom providers: Select a custom ETW provider and the tracing level. 根据其 GUDI 标识提供程序。Identify the provider by its GUID. 不要在 GUID 中包含括号。Don't include brackets in the GUID.
  • 已启用的提供程序:列出已启用的提供程序。Enabled providers: Lists the enabled providers. 从下拉列表中选择一个提供程序,然后单击或敲击“禁用”可停止跟踪。Select a provider from the dropdown and click or tap Disable to stop tracing. 单击或敲击“全部停止”会暂停所有跟踪。Click or tap Stop all to suspend all tracing.
  • 提供程序历史记录:显示已在当前会话期间启用的 ETW 提供程序。Providers history: Shows the ETW providers that were enabled during the current session. 单击或敲击“启用”可激活已禁用的提供程序。Click or tap Enable to activate a provider that was disabled. 单击或敲击“清除”可清除历史记录。Click or tap Clear to clear the history.
  • 事件:以表格格式列出来自选定提供程序的 ETW 事件。Events: Lists ETW events from the selected providers in table format. 此表将实时更新。This table is updated in real time. 在该表格下方,单击“清除”按钮可删除其中的所有 ETW 事件。Beneath the table, click the Clear button to delete all ETW events from the table. 这不会禁用任何提供程序。This does not disable any providers. 可以单击“保存到文件”以将当前收集的 ETW 事件本地导出到 CSV 文件。You can click Save to file to export the currently collected ETW events to a CSV file locally.
  • 筛选器:用于按 ID、关键字、级别、提供程序名称、任务名称或文本筛选收集的 ETW 事件。Filters: Allow you to filter the ETW events collected by ID, Keyword, Level, Provider Name, Task Name, or Text. 可将多个条件组合在一起:You can combine several criteria together:
    1. 对于应用到同一属性的条件,将显示可满足其中任何一个条件的事件。For criteria applying to the same property, events that can satisfy any one of these criteria are shown.
    2. 对于应用到不同属性的条件,事件必须满足所有条件For criteria applying to a different property, events must satisfy all of the criteria

例如,可以指定条件 (Task Name contains 'Foo' or 'Bar') AND (Text contains 'error' or 'warning')For example, you can specify the criteria (Task Name contains 'Foo' or 'Bar') AND (Text contains 'error' or 'warning')

模拟Simulation

Microsoft HoloLens 上 Windows 设备门户中的“模拟”页Simulation page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“模拟”页Simulation page in Windows Device Portal on Microsoft HoloLens

允许你记录和播放用于测试的输入数据。Allows you to record and play back input data for testing.

  • 捕获房间:用于下载模拟房间文件,该文件包含用户周围环境的空间映射网格。Capture room: Used to download a simulated room file that contains the spatial mapping mesh for the user's surroundings. 为该房间命名,然后单击“捕获”以在电脑上将该数据保存为 .xef 文件。Name the room and then click Capture to save the data as a .xef file on your PC. 此房间文件可以加载到 HoloLens 仿真器中。This room file can be loaded into the HoloLens emulator.
  • 录制:选中要录制的流、为录制内容命名,然后单击或敲击“录制”开始录制。Recording: Check the streams to record, name the recording, and click or tap Record to start recoding. 使用 HoloLens 执行操作,然后单击“停止”在电脑上将数据保存为 .xef 文件。Perform actions with your HoloLens and then click Stop to save the data as a .xef file on your PC. 可以在 HoloLens 仿真器或设备上加载此文件。This file can be loaded on the HoloLens emulator or device.
  • 播放:单击或敲击“上传录制内容”可从电脑中选择 xef 文件,然后将数据发送到 HoloLens。Playback: Click or tap Upload recording to select a xef file from your PC and send the data to the HoloLens.
  • 控制模式:在 HoloLens 上,从下拉列表中选择“默认”或“模拟”,然后单击或敲击“设置”按钮选中该模式。 Control mode: Select Default or Simulation from the dropdown, and click or tap the Set button to select the mode on the HoloLens. 相反,选择“模拟”会禁用 HoloLens 上的真实传感器,并使用已上载的模拟数据。Choosing "Simulation" disables the real sensors on your HoloLens and uses uploaded simulated data instead. 如果切换到“模拟”,HoloLens 将不会响应真实用户,除非切换回“默认”。If you switch to "Simulation", your HoloLens will not respond to the real user until you switch back to "Default".

网络Networking

Microsoft HoloLens 上 Windows 设备门户中的“网络”页Networking page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“网络”页Networking page in Windows Device Portal on Microsoft HoloLens

管理 HoloLens 上的 Wi-Fi 连接。Manages Wi-Fi connections on the HoloLens.

  • WiFi 适配器:使用下拉控件选择 Wi-Fi 适配器和配置文件。WiFi adapters: Select a Wi-Fi adapter and profile by using the dropdown controls. 单击或敲击“连接”以使用选定的适配器。Click or tap Connect to use the selected adapter.
  • 可用网络:列出 HoloLens 可连接到的 Wi-Fi 网络。Available networks: Lists the Wi-Fi networks that the HoloLens can connect to. 单击或敲击“刷新”可更新列表。Click or tap Refresh to update the list.
  • IP 配置:显示网络连接的 IP 地址和其他详细信息。IP configuration: Shows the IP address and other details of the network connection.

虚拟输入Virtual Input

Microsoft HoloLens 上 Windows 设备门户中的“虚拟输入”页Virtual Input page in Windows Device Portal on Microsoft HoloLens
Microsoft HoloLens 上 Windows 设备门户中的“虚拟输入”页Virtual Input page in Windows Device Portal on Microsoft HoloLens

将键盘输入从远程计算机发送到 HoloLens。Sends keyboard input from the remote machine to the HoloLens.

单击或敲击虚拟键盘下的区域可将键击发送到 HoloLens。Click or tap the region under Virtual keyboard to enable sending keystrokes to the HoloLens. 在“输入文本”文本框中键入内容,然后单击或敲击“发送”可将键击发送到活动应用。 Type in the Input text textbox and click or tap Send to send the keystrokes to the active app.

设备门户 REST APIDevice Portal REST API's

设备门户中的所有内容都是基于 REST API 创建的,你可以选择性地使用这些 API 来访问数据和以编程方式控制设备。Everything in the device portal is built on top of REST API's that you can optionally use to access the data and control your device programmatically.

故障排除Troubleshooting

如何消除“此处没有其他内容”消息How to fix the "It's lonely here" message

备注

如果页面在 HoloLens(第 1 代)上使用之前先在 HoloLens 2 上使用,那么在从 HoloLens 2 转到 HoloLens(第 1 代)后,可能导致只有这些页面,不显示其他任何内容。Going from a HoloLens 2 to HoloLens (1st gen) may cause the pages to become lonely if used on the HoloLens 2 prior to use on the HoloLens (1st gen).

“设备门户”页面中的“此处没有其他内容”消息

  1. 从右上角菜单中选择“重置布局”:Select Reset layout from the top-left Menu:

从设备门户菜单中选择“重置布局”

  1. 在“重置工作区”标题下单击“重置布局” 。Click Reset layout under the Reset workspace heading. 门户页面将自动刷新并显示你的内容。The portal page will automatically refresh and display your content.

从“重置工作区”页面中选择“重置布局”