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

Changwei | 4/30/2016 10:55:00 PM


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制作的,你可以利用它们通过编程来自定义访问数据和控制你的设备。