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制作的，你可以利用它們通過程式設計來自定義通路資料和控制你的裝置。