HoloLens开发手记 － 使用Windows设备控制台 Using Windows Device Portal

Windows设备控制台允许你通过Wi-Fi或USB来远程控制你的HoloLens设备。设备控制台是HoloLens上的一个Web Server，你可以通过PC的浏览器来连接到它。设备控制台包含了很多帮助你管理、调试和优化HoloLens设备的工具。

设置HoloLens以使用Windows设备控制台 Setting up HoloLens to use Windows Device Portal

---

1. 打开HoloLens，并穿戴上
2. 使用绽开手势打开开始菜单
3. 选中设置应用，在你放置它以后会自动启动
4. 选中更新选项
5. 选中开发者选项
6. 打开开发者模式
7. 滑动页面，打开设备控制台选项

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

---

1. 将HoloLens连上Wi-Fi
2. 找到你的IP地址
3. 在PC浏览器上前往https://<你设备的IP>
   • 浏览器会显示以下信息，“浏览器的证书存在问题”。这是因为Windows设备控制台的证书是测试证书，你现在可以忽略这个证书错误。

通过USB连接 Connecting over USB

---

1. 安装好开发工具，确保PC上已有Visual Studio 2015 Update 1及更新版本和Windows 10开发者工具。这保证了USB连接性。
2. 将HoloLens设备通过USB连接到PC
3. 在PC浏览器上前往http://127.0.0.1:10080

连接到模拟器 Connecting to an emulator

---

你也可以在模拟器上使用设备控制台。可以使用toolbar连接到设备控制台。点击下面这个图标：

•  Open Device Portal： 打开HoloLens模拟器的设备控制台

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

---

你首次连接到HoloLens上的设备控制台时，需要创建一个用户名和密码。

1. 在PC浏览器上访问HoloLens的IP地址，会打开一个设置页面
2. 点击Request pin，然后在HoloLens上查看生成的pin码
3. 输入设备上出现的pin码
4. 输入一个用户名用于连接HoloLens，不必是微软账户或者域账号
5. 重复输入密码，密码至少要有7个字符。不必是微软账号或者域账号密码。
6. 点击 Pair按钮来连接到HoloLens

任何时候如果你想修改用户名和密码，你可以点击页面顶部Security链接访问设备安全页面，或者直接访问：https://<YOUR_HOLOLENS_IP_ADDRESS>/devicesecurity.htm。

安全证书 Security certificate

---

如果你在浏览器里看到证书错误提示，可以通过信任HoloLens设备证书来修复此问题。

每台HoloLens设备都会生成一个自签名的证书用于SSL连接。默认情况下，此证书不会被你的浏览器信任，并显示证书错误。通过下载此证书，并在PC上信任它，你就可以安全的连接到设备了。

1. 确保处在安全的网络下
2. 从设备控制台安全（Security）页面下载设备证书
3. 安装证书到PC上的“受信任的信任根证书发行机构（Trusted Root Certification Authority）”目录
4. 重启浏览器

设备控制台页面 Device Portal Pages

---

设备管理会话起始于首页。从左边导航栏点击Home即可进入首页。

顶部工具栏提供了设备状态和一些特性内容。

• Online：指示设备是否连接到了Wi-Fi
• Shutdown：关闭设备
• Restart：重启
• Security：打开安全页面
• Cool：指示设备温度
• A/C：指示设备是否在充电
• Help：打开REST接口文档页

首页显示了以下信息：

• 设备状态：监视设备健康及报告致命错误
• Windows信息：显示HoloLens名字和当前系统版本
• 偏好设置 Preference区块包括以下内容：
  • IPD：设定瞳距，这是指用户直视前方瞳孔中心之间的距离，单位是毫米。此值被设置后自动生效，设备默认值是自动计算的。
  • 设备名：分配一个名字给设备，改名后必须重启后才能生效。
  • 休眠设置：设置设备进入休眠前等待的时长。

3D视图 3D View

---

使用3D视图页面来了解HoloLens如何解析周围环境。使用鼠标可以调整视图内容：

• 旋转：按住鼠标左键移动
• 平移：按住鼠标邮件移动
• 缩放：滚动鼠标滚轮
• 追踪选项：通过勾选Force visual tracking打开持续可视化追逐。勾选Pause会暂停追踪。
• 视图选项：
  • Tracking：指示可视化追踪是否激活
  • Show floor：显示一个方格平面图
  • Show frustum：显示一个视锥
  • Show stabilization plane：显示HoloLens用于稳定运动的平面
  • Show mesh：显示周围环境的表面映射网格
  • Show details：显示实时变化时，手的位置，头部转动参数，以及设备初始矢量
  • Full screen按钮：全屏模式显示3D视图，按Esc键可退出
• Surface reconstruction：点击Update按钮会显示最新的空间映射网格，有时候这个过程可能会花费一点时间。3D视图中的空间网格不会自动更新，你必须手动点击更新按钮来从设备中载入最新的网格数据。点击保存按钮可以将当前空间映射网格保存为obj文件存储到PC上。

混合现实捕获 Mixed Reality Capture

---

使用混合现实捕获可以保存来自HoloLens设备的媒体流。

• Settings：通过选中以下选项来控制媒体流
  • Holograms：捕获全息内容到视频流。全息图像已单声道渲染，而不是立体声
  • PV camera：从摄像头捕获视频流
  • Mic Audio：捕获麦克风阵列的声音
  • App Audio：捕获当前应用的声音
  • Live preview quality：为实时预览视频选择分辨率、帧率和流速
• 点击Live preview按钮来预览当前捕捉流内容。Stop live preview按钮用于停止预览捕捉流
• 点击Record按钮来开始使用指定设置来记录混合现实流。Stop recording用于结束纪录，并保存它
• 点击Take photo按钮从捕获流里获取一张照片
• Videos and photos：显示捕获的视频和照片列表

注意：当你从设备控制台纪录或实时预览捕获流时，HoloLens应用将不能捕获MRC视频或者照片

性能追踪 Performance Tracking

---

用于从HoloLens捕获Windows性能记录器（WPR）追踪内容

• Available profiles：选择WPR配置后点击Start开始性能追踪
• Custom profile：点击Browse从PC选择一个WPR配置文件。点击Upload and start开始性能捕捉

为了停止性能追踪，点击stop。停留在此页面直到性能追踪文件下载完成。

捕获到的ETL文件可以被Windows性能分析器打开并分析。

进程 Processes

---

显示当前运行进程的细节。包括了所有系统和应用进程。

系统性能 System Performance

---

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

以下是可获得的内容指标：

• SoC电源：平均每分钟瞬时系统芯片电量利用率
• System power：平均每分钟瞬时系统电量利用率
• Frame rate：每秒帧数，每秒丢失的空白帧数以及持续丢失的帧数
• GPU：GPU引擎利用率
• I／O：读写速度
• Network：接收到和发出的流量大小
• Memory：总内存、使用中、修改的、分页的以及不分页的内存情况

应用 Apps

---

管理安装在HoloLens上的应用。

• Installed apps：移除和开始应用
• Running apps：列出当前正在运行的应用
• Install app：从电脑上选择应用包来安装
• Dependency：添加安装包依赖项
• Deploy：部署应用和其依赖项到HoloLens

应用崩溃纪录页面 App Crash Dumps Page

---

这个页面允许你收集旁加载应用的崩溃日志。为每一个你想收集崩溃日志的应用选中 Crash Dump Enable，然后返回此页面收集崩溃日志。dump文件可以使用Visual Studio打开来调试。

Kiosk模式 Kiosk Mode

---

开启Kiosk模式后，会限制用户启动新应用或者改变正在运行应用的能力。Bloom手势和Cortana也将不能使用，环境中放置的其他应用也不会被显示。

选中Enable Kiosk Mode来使HoloLens进入kiosk模式。从Startup app里选择一个应用。点击Save来保存设定。

注意：即使Kiosk模式没有开启，应用也会在HoloLens启动时运行。选择 None则没有应用会开机启动。

日志 Logging

---

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

选中Hide providers以仅显示事件列表

• Registered providers：选择ETW提供者和追踪级别。追踪级别会是以下其中之一：
  1. Abnormal exit or termination 异常退出和终止
  2. Servere errors 严重错误
  3. Warnings 警告
  4. Non-error Warnings 无错误警告

点击Enable按钮开始追踪。被追踪者将会被添加到Enable Providers下拉框。

• Custom Providers：选择一个自定义ETW来源喝追踪级别。通过GUID来标志提供者。GUID不要包含括号
• Enable Providers：启动的ETW提供者来源
• Providers history：显示当前会话中被选中的ETW提供者
• Events：从选中的提供者以列表形式列出ETW事件
• Filters：允许你筛选通过ID、关键词、级别、提供者名字、任务名字或文本收集的ETW事件

仿真 Simulation

---

允许你纪录喝回放用于测试的输入数据。

• Capture room：用于下载一个包含用户周边环境空间映射网格数据的仿真房间文件，点击Save可以保存到本地计算机。房间文件可以导入到HoloLens模拟器使用。
• Recording：选中用于纪录的流，命名纪录后，开始进行纪录。在你的HoloLens上操作，然后点击Stop按钮将数据保存为.xef文件到PC上。此文件可以被HoloLens模拟器使用。
• Playback：点击 Upload recording按钮从PC上选择一个xef文件，然后发送数据到HoloLens上。
• Control mode：从下拉框选择 Default或者Simulation，点击Set按钮在HoloLens上启用此模式。选中“Simulation”，将会禁用HoloLens上真实的传感器，而使用上传的模拟数据。如果启用Simulation模式，HoloLens将不会响应真实用户直到切换回Default模式。

网络 Networking

---

管理HoloLens上的Wi-Fi连接。

虚拟输入 Virtual Input

---

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

点击Virtual Keyboard下方区域来放松键盘点击数据到HoloLens。在Input text中输入内容，然后点击Send按钮来发送内容到当前应用。

设备控制台Rest API's Device Portal REST API's

---

设备控制台里的所有内容都是基于REST API制作的，你可以利用它们通过编程来自定义访问数据和控制你的设备。