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
- 打开HoloLens，并穿戴上
- 使用绽开手势打开开始菜单
- 选中设置应用，在你放置它以后会自动启动
- 选中更新选项
- 选中开发者选项
- 打开开发者模式
- 滑动页面，打开设备控制台选项
通过Wi-Fi连接 Connecting over Wi-Fi
- 将HoloLens连上Wi-Fi
- 找到你的IP地址
- 在PC浏览器上前往https://<你设备的IP>
- 浏览器会显示以下信息，“浏览器的证书存在问题”。这是因为Windows设备控制台的证书是测试证书，你现在可以忽略这个证书错误。
通过USB连接 Connecting over USB
- 安装好开发工具，确保PC上已有Visual Studio 2015 Update 1及更新版本和Windows 10开发者工具。这保证了USB连接性。
- 将HoloLens设备通过USB连接到PC
- 在PC浏览器上前往http://127.0.0.1:10080
连接到模拟器 Connecting to an emulator
你也可以在模拟器上使用设备控制台。可以使用toolbar连接到设备控制台。点击下面这个图标：
Open Device Portal： 打开HoloLens模拟器的设备控制台
创建用户名和密码 Creating a Username and Password
你首次连接到HoloLens上的设备控制台时，需要创建一个用户名和密码。
- 在PC浏览器上访问HoloLens的IP地址，会打开一个设置页面
- 点击Request pin，然后在HoloLens上查看生成的pin码
- 输入设备上出现的pin码
- 输入一个用户名用于连接HoloLens，不必是微软账户或者域账号
- 重复输入密码，密码至少要有7个字符。不必是微软账号或者域账号密码。
- 点击 Pair按钮来连接到HoloLens
任何时候如果你想修改用户名和密码，你可以点击页面顶部Security链接访问设备安全页面，或者直接访问：https://<YOUR_HOLOLENS_IP_ADDRESS>/devicesecurity.htm。
安全证书 Security certificate
如果你在浏览器里看到证书错误提示，可以通过信任HoloLens设备证书来修复此问题。
每台HoloLens设备都会生成一个自签名的证书用于SSL连接。默认情况下，此证书不会被你的浏览器信任，并显示证书错误。通过下载此证书，并在PC上信任它，你就可以安全的连接到设备了。
- 确保处在安全的网络下
- 从设备控制台安全（Security）页面下载设备证书
- 安装证书到PC上的“受信任的信任根证书发行机构（Trusted Root Certification Authority）”目录
- 重启浏览器
设备控制台页面 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提供者和追踪级别。追踪级别会是以下其中之一：
- Abnormal exit or termination 异常退出和终止
- Servere errors 严重错误
- Warnings 警告
- 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制作的，你可以利用它们通过编程来自定义访问数据和控制你的设备。
