Windows デバイス ポータルを使用する

機能 HoloLens 第 1 世代 HoloLens 2
Windows デバイス ポータル ✔️ ✔️

HoloLens 用の Windows デバイス ポータルでは、Wi-Fi または USB 経由でリモートからデバイスを構成および管理できます。 Device Portal は HoloLens 上の Web サーバーであり、PC 上の Web ブラウザーから接続できます。 デバイス ポータルには、HoloLens を管理し、アプリをデバッグおよび最適化するのに役立つ多くのツールが用意されています。

このドキュメントは、特に HoloLens 用 Windows デバイス ポータルに関するものです。 デスクトップ用 Windows デバイス ポータル (Windows Mixed Reality 用を含みます) を使用するには、「Windows Device Portal の概要」を参照してください

Note

デバイス ポータルは開発者向けツールであり、組織に展開されたアプリケーションで使用するものではありません。

Windows デバイス ポータルを使用するように HoloLens をセットアップする

  1. HoloLens の電源をオンにして、デバイスに配置します。
  2. HoloLens 2 のスタート ジェスチャまたは HoloLens (第 1 世代) のブルームを使用して、メイン メニューを起動します。
  3. HoloLens (第 1 世代) 上では、[Settings]\(設定\) タイルを見つめてエアタップ ジェスチャを実行します。 HoloLens 2 上では、タッチするかハンド レイを使用してそれを選択することもできます。
  4. Update メニュー項目を選択します。
  5. 開発者メニュー項目を選択します。
  6. [開発者モード] を有効にします。

重要

管理者ではなくマルチユーザーの場合は、開発者モードに入る機能が淡色表示されることがあります。デバイスの 管理者であることを確認してください

  1. 下へスクロールし、デバイス ポータルを有効にします。
  2. USB または Wi-Fi 経由でこの HoloLens にアプリをデプロイできるように Windows デバイス ポータルを設定している場合は、[ペアリング] を選択して、ペアリング PIN を生成します。 最初のデプロイ中に Visual Studio に PIN を入力するまで、設定アプリは PIN ポップアップのままにしておきます。

Windows Holographic の設定アプリで開発者モードを有効にする

Wi-Fi 経由で接続する

  1. HoloLens を Wi-Fi に接続します
  2. 次のどちらかの方法でデバイスの IP アドレスを検索します。
  • [ Settings > ネットワークとインターネット > Wi-Fi > 詳細オプションに移動します。
  • Settings > Network & Internet に移動しHardware プロパティ選択します
  • "自分の IP アドレス" 音声コマンドを使用する。

HoloLens 2 の設定

  1. お使いの PC の Web ブラウザーで、https://<HoloLens の IP アドレス> に移動します
    • デバイス ポータルに発行された証明書がテスト証明書であるため、ブラウザーに "この Web サイトのセキュリティ証明書に問題があります" というメッセージが表示されます。 ここでは、この証明書エラーを無視して続行できます。

USB 経由で接続する

重要

IpOverUsb は、ポート 10080 の使用が必要であるため、新しいブラウザー標準では推奨されなくなりました。 それでも IpOverUsb を使用したい場合は、Visual Studio のインストール時に [USB デバイスの接続] ボックスをオンにしてください。このチェックボックスは、既定ではオフです。 代わりにお勧めするのは UsbNcm に接続することで、これは HoloLens 2 で既定でサポートされています。 HoloLens 1 を使用している場合は、WiFi を使用して PC に接続することをお勧めします。

  1. HoloLens 2 が Windows Holographic バージョン 21H1 以降を実行している場合は、設定アプリの [開発者向け] に進んで、[デバイスの検出] がオンになっていることを確認してください。
  2. USB-C ケーブルを使用して HoloLens 2 を PC に接続します。
  3. UsbNcm IP を探してください。 これを行う方法はいくつかあります。
  • デバイスの設定アプリで (この方法は、Windows Holographic バージョン 21H1 以降を実行している HoloLenses で、[デバイスの検出] がオンになっている場合のみ有効です)。

    1. デバイスの設定アプリにアクセスします。
    2. [更新とセキュリティ] > [開発者向け] に移動します。これは、Device Portal を有効にしたのと同じ場所です。
    3. ページの下部にある [イーサネット] IP アドレスをコピーします。 これが UsbNcm IP です。 HoloLens 2 の設定 - UsbNcm IP
  • デバイス ポータルで:

    1. デバイスで、HoloLens の WiFi アドレスを使用してデバイス ポータルを開きます。 HoloLens の WiFi アドレスがわからない場合は、「IP アドレスを教えて」音声コマンドを使用できます。
    2. [システム] > [ネットワーク] へ移動します
    3. ページの右端にある [IP 構成] パネルで、「説明: UsbNcm 関数」で始まるセクションを見つけます。
    4. UsbNcm IP は「IPv4 アドレス」の行です。 アドレスをコピーするか、アドレスをクリックしてください。これは、UsbNcm IP を使用してデバイス ポータルを開くハイパーリンクです。
  • コマンド プロンプトで:

    1. コマンド プロンプトで、Windows 10 SDK がインストールされている bin<SDK バージョン>\x86 フォルダー (C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x86 など) へ移動します。
    2. 「winappdeploycmd devices」と入力して、Enter キーを押します。
    3. 出力の中から、[モデル/名前] 列が HoloLens デバイス名になっているエントリ (HOLOLENS-xxxxxx など) を見つけます。 UsbNcm IP はこの行の先頭にあり、169.254.x.x の形式の自動プライベート IP アドレスになります。このアドレスをコピーします。
  1. UsbNcm IP をコピーした場合は、PC の Web ブラウザーで https:// の後に UsbNcm IP を付けてアクセスします。

USB 経由でファイルを移動する

追加の設定を行わずに、PC から HoloLens にファイルを移動することができます。

  1. USB コードを使用して PC を HoloLens に接続します
  2. ファイルをデスクトップ上の PC\[HoloLens デバイス名]\Internal Storage にドラッグします
  3. お使いの HoloLens で [スタート] メニューを開き、[すべてのアプリ] > [エクスプローラー] の順に選択します

Note

場合によっては、[Recently used]\(最近の使用\) から移動してファイルを探すために、パネルの左側にある [このデバイス] を選択する必要があります。

エミュレーターに接続する

エミュレーターで Device Portal を使用することもできます。 デバイス ポータルに接続するには、ツール バーを使用します。 このアイコンを選択します: [デバイス ポータルを開く] アイコン デバイス ポータルを開く: エミュレーターで HoloLens OS の Windows デバイス ポータルを開きます。

ユーザー名とパスワードを作成する

Windows デバイス ポータルへのアクセスを設定する
Windows デバイス ポータルへのアクセスを設定する

HoloLens で初めてデバイス ポータルに接続するときは、ユーザー名とパスワードを作成する必要があります。

  1. PC 上の Web ブラウザーで、HoloLens の IP アドレスを入力します。 [Setup access]\(アクセスのセットアップ\) ページが開きます。
  2. [Request pin]\(PIN の要求\) を選択またはタップし、生成された PIN を HoloLens のディスプレイで確認します。
  3. [PIN displayed on your device]\(デバイスに表示された PIN\) テキスト ボックスに PIN を入力します。
  4. デバイス ポータルへの接続に使うユーザー名を入力します。 Microsoft アカウント (MSA) 名またはドメイン名である必要はありません。
  5. パスワードを入力して確認します。 パスワードの長さは 7 文字以上にする必要があります。 MSA またはドメイン パスワードである必要はありません。
  6. [ペアリング] をクリックして、HoloLens の Windows デバイス ポータルに接続します。

このユーザー名またはパスワードは、デバイスのセキュリティ ページでこの手順を繰り返すことでいつでも変更できます。デバイスのセキュリティ ページを表示するには、https://<HoloLens の IP アドレス>/devicepair.htm にアクセスします。

セキュリティ証明書

ブラウザーで "証明書エラー" が表示される場合は、デバイスとの信頼関係を作成することで修正できます。

それぞれの HoloLens では、SSL 接続用に自己署名証明書が生成されます。 既定では、この証明書は PC の Web ブラウザーによって信頼されていないため、"証明書エラー" が発生する可能性があります。 この証明書を USB または信頼している Wi-Fi ネットワーク経由で HoloLens からダウンロードし、PC 上で信頼することにより、デバイスに安全に接続できます。

  1. 安全なネットワーク (USB または信頼している Wi-Fi ネットワーク) に接続していることを確認します。
  2. デバイス ポータルの [セキュリティ] ページから、このデバイスの証明書をダウンロードします。
    • https://<HoloLens の IP アドレス>/devicepair.htm に移動します
    • [システム] > [基本設定] ノードを開きます。
    • [デバイス セキュリティ] まで下にスクロールし、[Download this device's certificate]\(このデバイスの証明書をダウンロードする\) ボタンを選択します。
  3. 証明書を PC の "信頼されたルート証明機関" にインストールします。
    • Windows メニューから、「コンピューター証明書の管理」と入力し、アプレットを起動します。
    • [信頼されたルート証明機関] フォルダーを展開します。
    • [証明書] フォルダーを選択します。
    • [操作] メニューから、[すべてのタスク] > [インポート] の順に選択します。
    • デバイス ポータルからダウンロードした証明書ファイルを使用して、証明書のインポート ウィザードを完了します。
  4. ブラウザーを再起動します。

Note

この証明書はデバイスに対してのみ信頼されるため、デバイスがフラッシュされた場合、ユーザーはプロセスを再度実行する必要があります。

アプリケーションのサイドローディング

証明書のインストール

  1. Windows デバイス ポータルで、アプリ マネージャー ページに移動します。
  2. [Deploy apps]\(アプリのデプロイ\) セクションで、[証明書のインストール] を選択します。
  3. [Select certificate file (.cer) used to sign app package]\(アプリ パッケージに署名するために使用する証明書ファイル (.cer) の選択\) で、[ファイルの選択] を選択し、サイドロードするアプリ パッケージに関連付けられている証明書を参照します。
  4. [インストール] を選択すると、インストールが開始されます。

Windows デバイス ポータルで開いているアプリ マネージャー ページのスクリーンショット

アプリのインストール

Note

デバイス ポータルを使用してアプリを正常にインストールするには、証明書によって署名されている必要があります。アプリをインストールする前に、この証明書をデバイスにインストールする必要があります。 手順については、前のセクションを参照してください。

  1. Visual Studio からアプリ パッケージを作成したら、生成されたファイルからデバイスにリモートでインストールできます。

アプリ パッケージ ファイルの内容のスクリーンショット

  1. Windows デバイス ポータルで、アプリ マネージャー ページに移動します。
  2. アプリの [デプロイ] セクションで、[ローカル ストレージ] を選択します
  3. [Select the application package]\(アプリケーション パッケージの選択\) で、[ファイルの選択] を選択し、サイドロードするアプリ パッケージを参照します
  4. アプリのインストールと共にオプションまたはフレームワークのパッケージをインストールする場合は、それぞれのボックスをオンにし、[次へ] を選択します。

Windows デバイス ポータルのアプリ マネージャー ページが開かれ、[ローカル ストレージ] タブが強調表示されているスクリーンショット

  1. [インストール] を選択すると、インストールが開始されます。

Windows デバイス ポータルのアプリ マネージャー ページが開かれ、インストールが正常に完了しているスクリーンショット

インストールが完了したら、HoloLens の [All apps]\(すべてのアプリ\) ページに戻り、新しくインストールしたアプリケーションを起動します。

デバイス ポータル ページ

ホーム

Microsoft HoloLens の Windows デバイス ポータル ホーム ページ
Microsoft HoloLens の Windows デバイス ポータル ホーム ページ

[注] デバイス ポータルで構成された設定は、デバイス全体に適用され、再起動後も保持されます。 デバイス ポータルは開発者が使用するものであり、展開されたアプリケーションで使用するものではありません。

Device Portal セッションはホーム ページから開始されます。 ホーム ページの左側にあるナビゲーション バーから他のページにアクセスします。

ページの上部にあるツール バーは、よく使用される状態と機能にアクセスできます。

  • オンライン: デバイスが Wi-Fi に接続されているかどうかを示します。
  • [Shutdown](シャットダウン): デバイスをオフにします。
  • [Restart](再起動): デバイスの電源を入れ直します。
  • セキュリティ: [デバイスのセキュリティ] ページを開きます。
  • クール: デバイスの温度を示します。
  • A/C: デバイスが接続され、充電されているかどうかを示します。
  • ヘルプ: REST インターフェイスのドキュメント ページを開きます。

ホーム ページには、次の情報が表示されます。

  • [Device Status]\(デバイスの状態\): デバイスの正常性を監視し、重大なエラーを報告します。
  • [Windows information]\(Windows の情報\): HoloLens の名前と、現在インストールされている Windows のバージョンを表示します。
  • 基本設定 セクションには、次の設定が含まれています。
    • IPD: 補助間距離 (IPD) を設定します。 設定はすぐに有効になります。 既定値は、デバイスの設定時に自動的に計算されました。
    • デバイス名: HoloLens に名前を割り当てます。 この値を変更したらデバイスを再起動し、変更を有効にします。 [Save]\(保存\) をクリックすると、デバイスを今すぐ再起動するか、後で再起動するかをたずねるダイアログが表示されます。
    • スリープ設定: デバイスが電源に接続され、バッテリ使用時にスリープ状態になるまでの待機時間を設定します。

3D ビュー

Microsoft HoloLens の Windows デバイス ポータルの [3D View]\(3D ビュー\) ページ
Microsoft HoloLens の Windows デバイス ポータルの [3D View]\(3D ビュー\) ページ

[3D ビュー] ページを使用して、HoloLens が周囲をどのように解釈するかを確認します。 マウスを使用してビュー内を移動します。

  • 回転: 左クリック + マウス
  • パン: 右クリック + マウス
  • ズーム: マウス スクロール
  • [Tracking options]\(追跡オプション\)
    • [Force visual tracking]\(視覚追跡を強制\) をオンにすると、連続的な視覚追跡が有効になります。
    • [Pause]\(一時停止\): 視覚追跡を停止します。
  • 表示オプション: 3D ビューのオプションを設定します。
    • 追跡: ビジュアル追跡がアクティブかどうかを示します。
    • [床の表示: チェッカーが付いた床面を表示します。
    • [視錐台の表示: 視錐台を表示します。
    • 手ブレ補正平面の表示: HoloLens がモーションの安定化に使用する平面を表示します。
    • メッシュの表示: 周囲を表す空間マッピング メッシュを表示します。
    • 空間アンカーの表示: アクティブなアプリの空間アンカーを表示します。 アンカーを取得して更新するには、[更新] ボタンを選択します。
    • 詳細の表示: 手の位置、頭の回転四元数、およびデバイスの原点ベクトルがリアルタイムで変化するように表示します。
    • 全画面表示ボタン: 全画面表示モードの 3D ビューを表示します。 Esc キーを押して全画面表示を終了します。
  • サーフェス再構築: Update を選択またはタップして、デバイスの最新の空間マッピング メッシュを表示します。 全体の処理が完了するまでには、しばらくかかる可能性があります (最大で数秒)。 3D ビューではメッシュは自動的に更新されないため、デバイスから最新のメッシュを取得するには、手動で [更新] を選択する必要があります。 [Save]\(保存\) を選択すると、現在の空間マッピング メッシュが obj ファイルとして PC に保存されます。
  • 空間アンカー: アクティブなアプリの空間アンカーを表示または更新するには、[更新] を選択します。

Map Manager

Map Manager を使用すると、複数のデバイス間でマップを共有できます。これを使用して、場所に基づいたエンターテインメントの顧客に対して共有エクスペリエンスを設定できます。 このツールでは、システム マップおよびアンカーのインポートとエクスポートもできます。

Map Manager にアクセスするには、デバイス ポータルにログインし、[Mixed Reality] -> [Map Manager] の順に選択します。

Windows デバイス ポータルの [マップ マネージャー] ページMicrosoft HoloLens の Windows デバイス ポータルの [マップ マネージャー] ページ

マップをエクスポートおよびインポートする

マップをエクスポートするには、[Export System Map & Anchors]\(システム マップとアンカーのエクスポート\) を選択します。 この処理には時間がかかることがあります。マップがエクスポートされている間、30 から 60 秒間待機します。 完了すると、ブラウザーにファイルがダウンロードされます。

マップとアンカーをインポートするには、[Upload a map file]\(マップ ファイルのアップロード\)[Upload an anchor file]\(アンカー ファイルのアップロード\) をそれぞれ選択し、エクスポート済みのマップまたはアンカー ファイルを選択します。 アップロードされたマップまたはアンカー ファイルは、他の HoloLens デバイスからのものである場合もあります。

Note

HoloLens では、空間マッピング データベースをインポートおよびエクスポートすることもできます。 ただし、これは非 HoloLens デバイスでは機能しません。

Mixed Reality キャプチャ

Microsoft HoloLens の Windows デバイス ポータルの [Mixed Reality Capture]\(Mixed Reality キャプチャ\) ページ
Microsoft HoloLens の Windows デバイス ポータルの [Mixed Reality Capture]\(Mixed Reality キャプチャ\) ページ

重要

デバイス ポータルは開発者が使用するものであり、展開されたアプリケーションで使用するものではありません。 デバイス ポータルで構成された設定は、デバイス全体に適用され、再起動後も保持されます。 デバイス ポータルで変更されたすべての設定は、Mixed Reality キャプチャとアプリに適用されます。

Mixed Reality Capture ページを使用して、HoloLens からメディア ストリームを保存します。

  • キャプチャ設定: 次の設定を確認して、キャプチャされるメディア ストリームを制御します。
    • ホログラム: ビデオ ストリーム内のホログラフィック コンテンツをキャプチャします。 ホログラムはステレオではなくモノラルでレンダリングされます。
    • PV カメラ: 写真/ビデオ カメラからビデオ ストリームをキャプチャします。
    • マイク オーディオ: マイク配列からオーディオをキャプチャします。
    • アプリ オーディオ: 現在実行中のアプリからオーディオをキャプチャします。
    • カメラからレンダリング: 実行中のアプリによってサポート 場合は、キャプチャを写真/ビデオ カメラの視点から配置します (HoloLens 2 のみ)。
    • ライブ プレビューの品質: ライブ プレビューの画面解像度、フレーム レート、ストリーミング レートを選択します。
  • オーディオ設定 (HoloLens 2 のみ):
    • オーディオ メディア カテゴリ: マイクを処理するときに使用するカテゴリを選択します。 [既定] では環境の一部が含められ、[通信] ではバックグラウンド ノイズ キャンセルが適用されます。
    • アプリオーディオゲイン:アプリオーディオの音量に適用されるゲイン。
    • マイクオーディオゲイン:マイクオーディオの音量に適用されるゲイン。
  • 写真とビデオの設定 (HoloLens 2 バージョン 2004 以降):
    • キャプチャ プロファイル: 写真やビデオを撮影するときに使用するプロファイルを選択します。 プロファイルによって、使用可能な解像度とフレームレートが決まります。
    • 写真の解像度: 写真が撮影される解像度。
    • ビデオの解像度とフレーム レート: ビデオの解像度とフレーム レートを指定します。
    • ビデオ安定化バッファー: ビデオの撮影時に使用されるバッファー サイズ。 値が大きいほど、速い動きをより適切に補正できます。
  • [Live preview]\(ライブ プレビュー\) ボタンを選択またはタップすると、キャプチャ ストリームが表示されます。 [Stop live preview]\(ライブ プレビューの停止\) は、キャプチャ ストリームを停止します。
  • [Record]\(記録\) を選択またはタップすると、指定された設定を使って Mixed Reality ストリームのレコーディングが開始します。 [Stop recording]\(記録の終了\) は、レコーディングを終了して保存します。
  • [Take photo]\(写真の撮影\) を選択またはタップすると、キャプチャ ストリームから静止画像が取得されます。
  • [既定の設定を復元する] を選択またはタップすると、オーディオ、写真、ビデオの設定が既定の設定に復元されます。
  • ビデオと写真: デバイスで撮影されたビデオと写真のキャプチャの一覧を表示します。

このページのすべての設定は、Windows デバイス ポータルを使用して取得したキャプチャに適用されます。 [スタート] メニュー、ハードウェア ボタン、グローバル音声コマンド、Miracast、カスタム MRC レコーダーなどのシステム MRC にも適用されます。

設定 システム MRC に適用されます カスタム MRC レコーダーに適用されます
ホログラム いいえ いいえ
PV カメラ いいえ いいえ
マイク オーディオ いいえ いいえ
アプリ オーディオ いいえ いいえ
カメラからのレンダリング はい はい (オーバーライド可能)
ライブ プレビューの品質 いいえ いいえ
オーディオ メディア カテゴリ はい いいえ
アプリ オーディオ ゲイン はい はい (オーバーライド可能)
マイク オーディオ ゲイン はい はい (オーバーライド可能)
キャプチャ プロファイル はい いいえ
写真の解像度 はい いいえ
ビデオ解像度とフレームレート はい いいえ
ビデオ手ブレ補正バッファー はい はい (オーバーライド可能)

Note

同時に MRC には制限事項があります。

  • Windows デバイス ポータルがビデオを記録しているときに、アプリが写真やビデオ カメラにアクセスしようとすると、ビデオの記録が停止します。
    • HoloLens 2 では、アプリが SharedReadOnly モードで写真やビデオ カメラにアクセスした場合、ビデオの記録は停止されません。
  • アプリで写真やビデオ カメラがアクティブに使用されている場合、Windows デバイス ポータルで写真を撮影したり、ビデオを録画したりすることができます。
  • ライブストリーミング:
    • HoloLens (第 1 世代) では、Windows デバイス ポータルからのライブ ストリーミング中に、アプリで写真やビデオ カメラにアクセスすることはできません。
    • アプリで写真やビデオ カメラがアクティブに使用されている場合、HoloLens (第 1 世代) のライブ ストリームは失敗します。
    • HoloLens 2 では、アプリが ExclusiveControl モードで写真やビデオ カメラにアクセスしようとすると、ライブ ストリーミングが自動的に停止されます。
    • HoloLens 2 では、アプリで PV カメラがアクティブに使用されている間に、ライブ ストリームを開始できます。

パフォーマンス トレース

Microsoft HoloLens の Windows デバイス ポータルの [Performance Tracing]\(パフォーマンスのトレース\) ページ
Microsoft HoloLens の Windows デバイス ポータルの [Performance Tracing]\(パフォーマンスのトレース\) ページ

Windows Performance Recorder (WPR) のトレースを HoloLens からキャプチャします。

  • 使用可能なプロファイル: ドロップダウンから WPR プロファイルを選択し、 Start を選択またはタップしてトレースを開始します。
  • カスタム プロファイル: Browse を選択またはタップして、PC から WPR プロファイルを選択します。 [Upload and start]\(アップロードして開始\) を選択またはタップすると、トレースが開始します。

トレースを停止するには、停止リンクを選択します。 トレース ファイルのダウンロードが完了するまで、このページを閉じないでください。

キャプチャした ETL ファイルを開き、Windows パフォーマンス アナライザーで分析できます。

パフォーマンス トレースの詳細については、HoloLens パフォーマンス トレースの方法に関する記事を参照してください。

処理

Microsoft HoloLens の Windows デバイス ポータルの [プロセス] ページ
Microsoft HoloLens の Windows デバイス ポータルの [プロセス] ページ

現在実行中のプロセスの詳細を表示します。 これには、アプリとシステムの両方のプロセスが含まれます。

システム パフォーマンス

Microsoft HoloLens の Windows デバイス ポータルの [システム パフォーマンス] ページ
Microsoft HoloLens の Windows デバイス ポータルの [システム パフォーマンス] ページ

電力使用量、フレーム レート、CPU 負荷など、システム診断情報のリアルタイム グラフを表示します。

利用可能なメトリックを次に示します。

  • SoC 電力: 1 分間の平均システムオンチップ電力使用量
  • システム電力: 1 分間の平均システム電力使用量
  • フレーム レート: 1 秒あたりのフレーム数、1 秒あたりの VBlanks のミス数、連続したミスした VBlanks
  • GPU: GPU エンジンの使用率、使用可能な合計の割合
  • CPU: 使用可能な合計の割合
  • I/O: 読み取りと書き込み
  • ネットワーク: 受信および送信
  • メモリ: 合計、使用中、コミット済み、ページング済み、およびページなし

アプリ

Microsoft HoloLens の Windows デバイス ポータルの [アプリ] ページ
Microsoft HoloLens の Windows デバイス ポータルの [アプリ] ページ

HoloLens にインストールされているアプリを管理します。

  • インストールされているアプリ: アプリを削除して起動します。
  • 実行中のアプリ: 現在実行されているアプリを一覧表示します。
  • アプリのインストール: コンピューター/ネットワーク上のフォルダーからインストールするアプリ パッケージを選択します。
  • 依存関係: インストールするアプリの依存関係を追加します。
  • 展開: 選択したアプリと依存関係を HoloLens に展開します。

App Crash Dumps (アプリのクラッシュ ダンプ)

Microsoft HoloLens の Windows デバイス ポータルの [App Crash Dumps]\(アプリのクラッシュ ダンプ\) ページ
Microsoft HoloLens の Windows デバイス ポータルの [App Crash Dumps]\(アプリのクラッシュ ダンプ\) ページ

このページでは、サイドロードされたアプリのクラッシュ ダンプを収集できます。 クラッシュ ダンプを収集する各アプリについて、[Crash Dumps Enabled]\(クラッシュ ダンプ有効\) チェック ボックスをオンにします。 クラッシュ ダンプを収集するには、このページに戻ります。 ダンプ ファイルは、デバッグ用に Visual Studio で開くことができます。

エクスプローラー

Microsoft HoloLens の Windows デバイス ポータルの [エクスプローラー] ページ
Microsoft HoloLens の Windows デバイス ポータルの [エクスプローラー] ページ

ファイルを参照、アップロード、ダウンロードするには、ファイル エクスプローラーを使用します。 ドキュメント フォルダー、ピクチャ フォルダー、および Visual Studio やデバイス ポータルから展開されたアプリ用のローカル ストレージ フォルダー内のファイルを操作できます。

キオスク モード

Note

キオスク モードは、Microsoft HoloLens Commercial Suite でのみ使用できます。

Microsoft HoloLens 上の Windows デバイス ポータルのキオスク モード ページ

Windows デバイス ポータルを使用してキオスク モードを有効にするための最新の手順については、Windows IT Pro Center の「キオスク モードでの HoloLens のセットアップ」記事を参照してください。

ログ機能

Microsoft HoloLens の Windows デバイス ポータルの [Logging]\(ログ記録\) ページ
Microsoft HoloLens の Windows デバイス ポータルの [Logging]\(ログ記録\) ページ

HoloLens 上のリアルタイム Windows イベント トレーシング (ETW) を管理します。

[Hide Providers]\(プロバイダを非表示にする\) チェックボックスをオンにすると、[Events]\(イベント\) の一覧のみが表示されます。

  • 登録済みプロバイダー: ETW プロバイダーとトレース レベルを選択します。 トレース レベルは、次のいずれかの値です。
    1. 異常終了または終了
    2. 重大なエラー
    3. 警告
    4. エラーではない警告

トレースを開始するには、[有効にする] を選択またはタップします。 [Enabled Providers] (有効なプロバイダー) ドロップダウン リストにプロバイダーが追加されます。

  • [Custom providers](カスタム プロバイダー): カスタム ETW プロバイダーとトレース レベルを選択します。 GUID を使用してプロバイダーを識別します。 GUID に角かっこを含めないでください。
  • 有効なプロバイダー: 有効なプロバイダーが一覧表示されます。 ドロップダウンからプロバイダーを選択し、[Disable] (無効にする) をクリックまたはタップしてトレースを停止します。 すべてのトレースを中断するには、[Stop All] (すべて停止) をクリックまたはタップします。
  • プロバイダー履歴: 現在のセッション中に有効にされた ETW プロバイダーが表示されます。 無効になっているプロバイダーをアクティブ化するには、[Enable] (有効にする) をクリックまたはタップします。 履歴をクリアするには、[Clear] (クリア) をクリックまたはタップします。
  • イベント: 選択したプロバイダーからの ETW イベントをテーブル形式で一覧表示します。 このテーブルはリアルタイムで更新されます。 テーブルの下にある Clear ボタンをクリックして、テーブルからすべての ETW イベントを削除します。 これによってプロバイダーが無効になることはありません。 [ファイルに保存 ] をクリックすると 現在収集されている ETW イベントを CSV ファイルにローカルにエクスポートできます。
  • フィルター: ID、キーワード、レベル、プロバイダー名、タスク名、またはテキストによって収集された ETW イベントをフィルター処理できます。 複数の条件を組み合わせることができます。
    1. 同じプロパティに適用する条件では、これらの条件のいずれかを満たすことができるイベントが表示されます。
    2. 異なるプロパティに適用する条件では、イベントはすべての条件を満たしている必要があります

たとえば、(Task Name contains 'Foo' or 'Bar') AND (Text contains 'error' or 'warning') のような条件を指定できます

シミュレーション

Microsoft HoloLens の Windows デバイス ポータルの [シミュレーション] ページ
Microsoft HoloLens の Windows デバイス ポータルの [シミュレーション] ページ

テスト用の入力データを記録して再生できます。

  • キャプチャ ルーム: ユーザーの周囲の空間マッピング メッシュを含むシミュレートされたルーム ファイルをダウンロードするために使用します。 ルームに名前を付けて [Capture]\(キャプチャ\) をクリックすると、データが .xef ファイルとして PC に保存されます。 このルーム ファイルは、HoloLens エミュレーターに読み込むことができます。
  • 記録: 録音するストリームを確認し、録音に名前を付け、 Record をクリックまたはタップして再コーディングを開始します。 HoloLens でアクションを実行した後、[Stop]\(停止\) をクリックすると、データが .xef ファイルとして PC に保存されます。 このファイルは、HoloLens エミュレーターまたはデバイスに読み込むことができます。

    Note

    記録機能を使用できるのは、現在は HoloLens 第 1 世代だけです。 HoloLens 2 では記録がまだサポートされていませんが、既存の記録の再生はサポートされています。

  • 再生: アップロード記録 をクリックまたはタップして、PC から xef ファイルを選択し、HoloLens にデータを送信します。
  • 制御モード: ドロップダウンから Default または Simulation を選択し、 Set ボタンをクリックまたはタップして HoloLens のモードを選択します。 [シミュレーション] を選択すると、HoloLens の実際のセンサーが無効になり、代わりにアップロードされたシミュレートされたデータが使用されます。 [Simulation]\(シミュレーション\) に切り替えると、[Default]\(既定\) に戻すまで、HoloLens は実際のユーザーに応答しなくなります。

ネットワーク

Microsoft HoloLens の Windows デバイス ポータルの [ネットワーク] ページ
Microsoft HoloLens の Windows デバイス ポータルの [ネットワーク] ページ

HoloLens での Wi-Fi 接続を管理します。

  • WiFi アダプター: ドロップダウン コントロールを使用して、Wi-Fi アダプターとプロファイルを選択します。 選択したアダプターを使用するには、[Connect]\(接続\) をクリックまたはタップします。
  • 使用可能なネットワーク: HoloLens が接続できる Wi-Fi ネットワークを一覧表示します。 一覧を更新するには、[Refresh]\(最新の情報に更新\) をクリックします。
  • IP 構成: ネットワーク接続の IP アドレスとその他の詳細が表示されます。

PowerThermalSDK テスト

Microsoft HoloLens に関する Windows デバイス ポータルの PowerThermalSDK テスト ページ
Microsoft HoloLens に関する Windows デバイス ポータルの PowerThermalSDK テスト ページ

PowerThermalNotification SDK の使用については、 「電力と温度の管理」を参照してください。

このページを使用して、SDK で使用される軽減策レベルと温度スコアを監視および制御します。 また、このページは、アクティブなアプリケーションによってどの周辺機器で軽減策が抑制されているかの詳細も提供します。

Note

このページは、PowerThermalNotification SDK をサポートしている OS ビルドでのみ使用できます

仮想入力

Microsoft HoloLens の Windows デバイス ポータルの [Virtual Input]\(仮想入力\) ページ
Microsoft HoloLens の Windows デバイス ポータルの [Virtual Input]\(仮想入力\) ページ

リモート コンピューターから HoloLens にキーボード入力を送信します。

[Virtual keyboard]\(仮想キーボード\) の下にある領域をクリックまたはタップすると、HoloLens にキー入力を送信できるようになります。 [Input text]\(テキストの入力\) テキスト ボックスに入力し、[Send]\(送信\) をクリックまたはタップすると、アクティブなアプリにキー入力が送信されます。

デバイス ポータル REST API

デバイス ポータルの機能はすべて、必要に応じてプログラムからデータにアクセスしてデバイスを制御するために使用できる REST API の上に構築されています。

トラブルシューティング

"It's lonely here" メッセージの修正方法

Note

HoloLens 2 から HoloLens (第 1 世代) へ移動する場合、HoloLens (第 1 世代) で使用する前に HoloLens 2 で使用されていると、ページが見つからない場合があります。

デバイス ポータル ページでの

  1. 左上のメニューから [Reset layout]\(レイアウトのリセット\) を選択します。

デバイス ポータル メニューから [レイアウトのリセット] を選択する

  1. [Reset workspace]\(ワークスペースのリセット\) 見出しの下にある [Reset layout]\(レイアウトのリセット\) をクリックします。 ポータル ページは自動的に更新され、コンテンツが表示されます。

[Reset workspace]\(ワークスペースのリセット\) ページで [Reset layout]\(レイアウトのリセット\) を選択する