次の方法で共有

HoloLens エミュレーターの使用

  • [アーティクル]

HoloLens エミュレーターを使用すると、HoloLens 開発ツールセットを含む、物理的な HoloLens を使用せずに、PC 上のホログラフィック アプリケーションをテストできます。 エミュレーターは Hyper-V 仮想マシンを使用します。つまり、HoloLens センサーによって読み取られる人間と環境の入力は、キーボード、マウス、または Xbox コントローラーからシミュレートされます。 エミュレーターで実行するようにプロジェクトを変更する必要もありません。アプリは、実際の HoloLens で実行されていないことを認識しません。

Windows Mixed Realityイマーシブ (VR) ヘッドセット アプリケーションまたはデスクトップ PC 用のゲームを開発する場合は、デスクトップ ヘッドセットをシミュレートできるWindows Mixed Reality シミュレーターをチェックします。

HoloLens 2 エミュレーターの概要

HoloLens エミュレーターのインストール

HoloLens エミュレーターをダウンロードします。

バージョン：

HoloLens エミュレーターのシステム要件

HoloLens エミュレーターでは、ハードウェア アクセラレータグラフィックスに Hyper-V と RemoteFx (最初の Gen Emulator) または GPU-PV (HoloLens 2 Emulator) が使用されます。 エミュレーターを使用するには、PC が次のハードウェア要件を満たしていることを確認します。

  • 64 ビット Windows 10 Pro、エンタープライズ、または Education

    注:

    Windows 10 Home Edition では、Hyper-V または HoloLens エミュレーターはサポートされていません。
    HoloLens 2 エミュレーターには、2018 年 10 月以降Windows 10更新プログラムが必要です。

  • 64 ビット CPU
  • 4 コアの CPU (または合計 4 コアの複数の CPU)
  • 8 GB 以上の RAM
  • BIOS では、次の機能を サポートして有効にする必要があります。
    • ハードウェア支援仮想化
    • 第 2 レベルのアドレス変換 (SLAT)
    • ハードウェア ベースのデータ実行防止 (DEP)
  • GPU 要件
    • DirectX 11.0 以降
    • WDDM 1.2 グラフィックス ドライバー以降 (第 1 世代)
    • WDDM 2.5 グラフィックス ドライバー (HoloLens 2 エミュレーター)
    • エミュレーターはサポートされていない GPU で動作する可能性がありますが、速度は低下します

システムが上記の要件を満たしている場合 は、システムで "Hyper-V" 機能が有効になっていることを確認します。 [コントロール パネル -> プログラム - > プログラムと機能 ] -> [Windows 機能のオンとオフを切り替える] に移動し、Hyper-V が選択されていることをチェックします。

HoloLens エミュレーターへのアプリの展開

  1. Visual Studio でアプリケーション ソリューションを読み込みます。

    注:

    Unityを使用する場合は、Unityからプロジェクトをビルドし、ビルドされたソリューションを通常どおり Visual Studio に読み込みます。

  2. HoloLens Emulator (第 1 世代) の場合は、[プラットフォーム] が [x86] に設定されていることを確認します。 HoloLens 2 エミュレーターの場合は、プラットフォームが x86 または x64 に設定されていることを確認します。
  3. デバッグのターゲット デバイスとして必要 な HoloLens エミュレーター のバージョンを選択します。
  4. [デバッグ] > [デバッグの開始] に移動するか、F5 キーを押してエミュレーターを起動し、デバッグ用にアプリケーションをデプロイします。

エミュレーターを初めて起動するときに、起動に 1 分以上かかる場合があります。 アプリケーションをエミュレーターにすばやくデプロイできるように、デバッグ セッション中はエミュレーターを開いたままにしておくことをお勧めします。

基本的なエミュレーター入力

エミュレーターの制御は、多くの一般的な 3D ビデオ ゲームに似ています。 入力オプションは、キーボード、マウス、または Xbox コントローラーを使用するために使用できます。 HoloLens を装着して、シミュレートされたユーザーのアクションを指示することでエミュレーターを制御します。 アクションは、シミュレートされたユーザーを環境の周りに移動します。 エミュレーターで実行されているアプリケーションは、実際のデバイスと同様に応答します。

HoloLens (第 1 世代) のカーソルは、頭の動きと回転に従います。 HoloLens 2 エミュレーターでは、カーソルは手の動きと向きに従います。

  • 前方、背面、左、右へ進 む - キーボードの W、A、S、D キー、または Xbox コントローラーの左スティックを使用します。
  • 上、下、左、右を見る - マウスを選択してドラッグし、キーボードの矢印キーまたは Xbox コントローラーの右スティックを使用します。
  • エア タップ ジェスチャ - マウスを右クリックし、キーボードの Enter キーを押すか、Xbox コントローラーの A ボタンを使用します。
  • ブルーム/システム ジェスチャ - キーボードの Windows キーまたは F2 キーを押すか、Xbox コントローラーの B ボタンを押します。
  • スクロール用の手の動き - Alt キーとマウスの右ボタンを同時に押しながら、マウスを上下にドラッグします。 Xbox コントローラーで、右トリガーと A ボタンを押したまま、右スティックを上下に動かします。
  • 手の動きと向き (HoloLens 2 エミュレーターのみ) - Alt キーを押しながら、マウスを上下左右にドラッグして手を動かします。 また、矢印キーと Q または E を使用して、手を回転および傾けることもできます。 Xbox コントローラーの場合は、左または右のバンパーを押したまま、左サムスティックを使用して、手を左、右、前方、背面、右サムスティックで回転させます。 Dpad を上下に使用して、手を上げたり下げたりします。

Windows Mixed Realityイマーシブ ヘッドセットをお持ちですか? HoloLens 2 エミュレーター (Windows Holographic バージョン 2004) 以降では、Windows Mixed Realityイマーシブ ヘッドセットとモーション コントローラーを使用して、HoloLens 2 エミュレーターを制御し、ステレオで表示できます。 HoloLens 2 エミュレーターでのWindows Mixed Realityイマーシブ ヘッドセットとモーション コントローラーの使用に関するページを参照してください

HoloLens 2 エミュレーターの構造

メイン ウィンドウ

HoloLens 2 エミュレーターの [メイン] ウィンドウ

ツールバー

[メイン] ウィンドウの右側にあるエミュレーター ツール バーを見つけます。 ツール バーには、次のボタンが含まれています。

  • 閉じるアイコン 閉じる: エミュレーターを閉じます。
  • 最小化アイコン 最小化: エミュレーター ウィンドウを最小化します。
  • Simulation_icon シミュレーション コントロール パネル: エミュレーターへの入力を構成および制御するためのシミュレーション コントロール パネルを表示または非表示にします。
  • [画面に合わせる] アイコン [ 画面に合わせる]: エミュレーターを画面に合わせて調整します。
  • ズーム アイコン ズーム : エミュレーターを大きく小さくします。
  • ヘルプ アイコン ヘルプ : エミュレーターのヘルプを開きます。
  • デバイス ポータル アイコンを開く デバイス ポータルを開く: エミュレーターで HoloLens OS の Windows デバイス ポータルを開きます。
  • [ツール] アイコン [ツール]: [その他のツール ] ウィンドウを開きます。

シミュレーション コントロール パネル

シミュレーション コントロール パネルを使用すると、シミュレートされた人間と入力デバイスの現在の位置と向きを表示できます。 また、一方または両方の手の表示や非表示などのシミュレートされた入力と、PC のキーボード、マウス、ゲームパッドなどのシミュレートされた入力を制御するために使用されるデバイスの両方を構成することもできます。

シミュレーション コントロール パネル

  • シミュレーション パネルを非表示または表示するには、ツール バー ボタンを選択するか、キーボードの F7 キーを押します。
  • コントロールまたはフィールドの上にマウス ポインターを合わせると、キーボード、マウス、ゲームパッドのコントロールを含むヒントが表示されます。
  • 手の表示/非表示を切り替えるには、[左手] または [右手] の下の適切なスイッチを切り替えます。
  • 手をコントロールするには、キーボードの左または右の Alt キー、またはゲームパッドの左または右のバンパーを使用します。
  • すべての入力を 1 つまたは両方の手に送信するには、トグル スイッチの下にあるプッシュピン ボタンを選択します。これは、手の Alt キーを押すのと同じです。
  • 視線視線入力の方向を制御するには、[目] セクションでプッシュピンを選択します。これは、キーボードの Y キーを押したままにした場合と同じです。
  • 会議室の記録を読み込むには、[記録] セクションの [読み込み] ボタンを選択します。 詳細については、「 シミュレートされたルーム 」を参照してください。
  • シミュレートされた人間または入力デバイスがキーボード、マウス、またはゲームパッドの入力に応答して移動または回転する速度を調整するには、[入力設定] の横にある歯車アイコンを選択し、スライダーを調整します。
  • 既定では、キーボード入力は、シミュレートされた人間とシミュレートされた入力を制御します。 PC のキーボード入力を HoloLens に送信するには、[シミュレーションにキーボードを使用する] をオフにします。 F4 は、この設定のショートカット キーです。
  • シミュレーション パネルが既に表示されている場合は、F8 キーを押すとキーボード フォーカスが移動します。
  • エミュレーター ウィンドウからシミュレーション パネルをドッキング解除するには、パネルの下部にあるボタンを選択するか、キーボードの F9 キーを押します。 ウィンドウを閉じるか、F9 キーをもう一度押すと、ウィンドウがエミュレーターに返されます。
  • シミュレーション コントロール パネルは別のアプリケーションとして起動できます。これにより、%ProgramFiles(x86)%\Windows Kits\10\Microsoft XDE\10.0.18362.0 から PerceptionSimulationInput.exe を実行することで、HoloLens 2 エミュレーター、HoloLens 2 デバイス、またはWindows Mixed Reality シミュレーションに接続して制御できます。

[アカウント] タブ

[アカウント] タブでは、Microsoft アカウントでサインインするようにエミュレーターを構成できます。 これは、ユーザーがアカウントでサインインする必要がある API をテストする場合に便利です。 このオプションを切り替える場合は、設定を有効にするために HoloLens エミュレーターを完全に閉じて再起動する必要があります。 このオプションを有効にすると、ユーザーが初めて HoloLens を開始したときと同様に、エミュレーターの後で起動するとサインインするように求められます。 PC のキーボードを使用して資格情報を入力するには、まず [シミュレーション] コントロール パネルで [シミュレーションにキーボードを使用する] をオフにするか、キーボードの F4 キーを押してキーボードの設定をオンまたはオフに切り替えます。

[省略可能な設定] タブ

[オプションの設定] タブには、ハードウェアアクセラレータグラフィックスを有効または無効にするコントロールが表示されます。 ハードウェア アクセラレータ グラフィックスは、PC のグラフィックス アダプター ドライブでサポートされている場合、既定で使用されます。 グラフィックス アダプターのドライバーが GPU-PV をサポートしていない場合、このオプションは表示されません。

[診断] タブ

[診断] タブには、仮想 GPU の状態と共に、Windows デバイス ポータルへのリンクの形式でエミュレーターの IP アドレスが表示されます。

[ネットワーク] タブ

[ネットワーク] タブには、エミュレーターのネットワーク アダプターの詳細と、ホスト コンピューターのネットワーク アダプターの詳細が表示されます。 HoloLens 2 エミュレーターの場合、このタブは、Windows 10 May 2019 Update 以降でエミュレーターを実行している場合にのみ表示されます。

[NAT 構成] タブ

このタブは、Windows 10 May 2019 Update以降でエミュレーターを実行している場合にのみ表示されます。

エミュレーターは、PC のネットワーク接続を使用し、NAT の背後に置きます。 このタブを使用すると、ホスト PC のポートをエミュレーターにマップできます。これにより、リモート デバイスはエミュレーターで実行されているアプリケーションやサービスに接続できます。

たとえば、リモート PC からエミュレーターのデバイス ポータルにアクセスする場合は、次のようにします。

  1. テーブル内の空き行をダブルクリックして、内部ポート 80 (デバイス ポータルがリッスンしているポート) のエントリを追加します。 他のアプリケーションの場合は、そのアプリケーションがリッスンしているポート番号を入力します。
  2. 使用可能な外部ポートを選択します。 この例では、外部ポートとしてポート 8080 を使用します。
  3. プロトコルを選択します。 既定値は TCP です。 デバイス ポータルでは TCP が使用されるため、既定値のままにします。
  4. [変更の適用] をクリックしてマッピングを有効にします。 'Status' は 'Pending' から 'Active' に変更されます。
  5. リモート PC でブラウザーを開き、 (IP-of-the-PC-running-the-emulator):8080 に移動します。 デバイス ポータル インターフェイスが表示されます。 リモート PC で使用する IP アドレスは、エミュレーター自体ではなく、エミュレーターを実行している PC の IP アドレスである必要があります。 PC の [ネットワーク & インターネット] カテゴリの [設定] アプリ、コマンド プロンプトの [ipconfig] 、エミュレーター の [ツール] ダイアログの [ネットワーク] タブからデスクトップ アダプターエントリを探して、さまざまな方法で IP を取得できます。

また、Device Portal のポート マッピングを追加する場合は、エミュレーターのインストールに含まれている Perception Simulation Control ツールを使用するか、または上記の例の 8080 などのホスト PC の IP アドレスと Device Portal 外部ポートに接続することで、Perception Simulation API を使用してエミュレーターをリモートで制御できることに注意してください。 Perception Simulation Control を使用してエミュレーターにリモートで接続して制御する場合は、PC の IP アドレスと構成されたポートのみを指定します。 'https://' は含めないでください。

既定では、ポート マッピングはありません。 構成したマッピングは、HoloLens 2 エミュレーターの起動間で永続的であり、エミュレーターが完全に起動されると自動的に有効になります。

[エクスポート] ボタンを使用して、マッピングをファイルに保存します。 その後、[インポート] ボタンを使用して同じマッピングを自動的に構成できる他のチーム メンバーとこのファイルを共有できます。

HoloLens エミュレーターの [NAT 構成] タブ

[Updates] タブ

このタブは、Windows 10 May 2019 Update以降でエミュレーターを実行している場合にのみ表示されます。

起動時に、エミュレーターは新しいバージョンにチェックします。 新しいバージョンが使用可能な場合は、エミュレーターに、使用可能なバージョンと共に、使用できるバージョンを示すプロンプトが表示され、更新するかどうかを確認するメッセージが表示されます。 [はい] を選択すると、新しいバージョンのインストーラーがダウンロードされます。

[Updates] タブでは、エミュレーターが新しいバージョンをチェックするかどうかを制御するには、このタブの [更新プログラムの自動チェック] チェックボックスを切り替えてください。また、2019 年 9 月の更新プログラム以降、使用可能な他のエミュレーター バージョンを表示およびダウンロードすることもできます。 現在実行されているバージョン以外のバージョンの場合は、ダウンロード リンクが提供されます。 このリンクをクリックすると、そのバージョンのインストーラーがダウンロードされます。

HoloLens Emulator の [Updates] タブ

HoloLens 2 エミュレーターでWindows Mixed Realityイマーシブ ヘッドセットとモーション コントローラーを使用する

HoloLens 2 エミュレーター (Windows Holographic バージョン 2004) 以降では、Windows Mixed Reality ヘッドセットとモーション コントローラーを使用して、HoloLens 2 エミュレーターをステレオで表示および操作できます。 これにより、HoloLens 2デバイスなしで頭と手で、より速く、より自然な動きをすることができます。 HoloLens 2 デバイスの完全な置き換えではありませんが、2D デスクトップ ウィンドウでキーボード、マウス、ゲームパッドを使用してエミュレーターを操作する以外にエクスペリエンスを向上させることを目的としています。 この機能を有効にするには:

  1. PC でWindows Mixed Realityが構成され、Windows Mixed Realityイマーシブ ヘッドセットが接続されていることを確認します。
  2. HoloLens 2 エミュレーターを起動する
  3. ツール バー ボタンをクリックするか、F7 キーを押して、[シミュレーション] パネルを開きます。
  4. パネルを一番下までスクロールします。
  5. [シミュレーションに HMD を使用する] というラベルの付いたボックスをオンにします
  6. Windows Mixed Realityが起動し、エミュレーターの表示が若干変わります。 ヘッドセットがないと、エミュレーターは両方の目を頭の中央に配置し、1 つの目のみを表示します。 ヘッドセットでは、エミュレーターは真のステレオ出力を生成しますが、デスクトップ ウィンドウには 1 つの目のみをレンダリングしますが、両方の目はヘッドセットにレンダリングされます。
  7. 必要に応じて、一方または両方のモーション コントローラーをオンにします。 コントローラー入力はエミュレーターの手入力にマップされます。 たとえば、タップするには、モーション コントローラーでトリガーをプルします。 移動するには、サムスティックを使用します。 コントロールの完全な一覧については、「Advanced HoloLens Emulator」と「Mixed Reality シミュレーターの入力」を参照してください。

ヘッドセットにコンテンツが表示されない場合

  • ヘッドセットとMixed Reality ポータルの両方で表示が空白で、デスクトップの [HoloLens 2 エミュレーター] ウィンドウにコンテンツが表示される場合は、エミュレーターでハードウェア グラフィックス アクセラレータが有効になっていることを確認します。 イマーシブ ヘッドセットWindows Mixed Realityサポートするには、エミュレーターでハードウェア グラフィックス アクセラレーションを有効にする必要があります。
  • ヘッドセットにコンテンツが表示されていてもホログラムがぼやけている場合、または二重の画像が表示される場合は、次の手順に従って、目のステレオ ビューを調整します。
  1. [シミュレーションに HMD を使用する] を一時的にオフにします。
  2. レジストリ エディターを起動する (regedit.exe)
  3. [HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\PerceptionSimulation] に移動します
  4. "EnableEyePoseControl" という名前の新しい DWORD 値を作成し、その値を 1 に設定します。
  5. エミュレーターで "シミュレーションに HMD を使用する" を有効にします。
  6. ヘッドセットにコンテンツが表示されたら、矢印キーを使用して目の回転を調整します。 左 Alt キーを押しながら左目を調整し、右 Alt キーを押して右目を調整します。 'Q' と 'E' を使用して目ごとにロールを調整し、目に適切な Alt キーをもう一度押します。 目の間隔を調整するには、'+' キーと '-' キーを使用します。 (数値パッドの +/- は機能しないことに注意してください。メイン キーボードのボタンを使用します。
  7. ステレオ ビューが正しく表示されたら、'S' キーを押して変更を保存します。 エミュレーターの今後の起動のために、新しい構成が保存されます。
  8. 変更を破棄して以前の構成に戻す場合は、'L' キーを押して既定または以前の構成を読み込みます。
  9. レジストリの "EnableEyePoseControl" の値を 0 に変更し、[シミュレーションに HMD を使用する] オプションを循環します。

構成を保存して削除する場合は、HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\PerceptionSimulation で "DisplayConfiguration" という名前の値を削除できます。 現在エミュレーターでヘッドセットを使用している場合は、"シミュレーションに HMD を使用する" をオフにし、再度オンにして、この変更が有効になっていることを確認する必要があります。

HoloLens (第 1 世代) エミュレーターの構造

メイン ウィンドウ

エミュレーターが起動すると、ウィンドウが表示され、HoloLens OS が表示されます。

HoloLens Emulator メイン ウィンドウ

ツールバー

メイン ウィンドウの右側に、エミュレーター ツール バーがあります。 ツール バーには、次のボタンが含まれています。

  • 閉じるアイコン 閉じる: エミュレーターを閉じます。
  • 最小化アイコン 最小化: エミュレーター ウィンドウを最小化します。
  • 人間入力アイコン [人間の入力]: マウスとキーボードを使用して 、エミュレーターへの人間の入力をシミュレートします。
  • キーボードとマウスの入力アイコン キーボードとマウスの入力: キーボードとマウスの入力は、キーボードとマウスのイベントとして HoloLens OS に直接渡されます。キーボードとマウスをBluetooth接続した場合と同様です。
  • [画面に合わせる] アイコン [ 画面に合わせる]: エミュレーターを画面に合わせて調整します。
  • ズーム アイコン ズーム : エミュレーターを大きく小さくします。
  • ヘルプ アイコン [ ヘルプ]: エミュレーター ヘルプを開きます。
  • デバイス ポータル アイコンを開く デバイス ポータルを開く: エミュレーターで HoloLens OS の Windows デバイス ポータルを開きます。
  • [ツール] アイコン [ツール]: [その他のツール ] ウィンドウを開きます。

[シミュレーション] タブ

[ その他のツール ] ウィンドウ内の既定のタブは、[ シミュレーション ] タブです。

HoloLens Emulator の [その他のツール] ウィンドウ

[シミュレーション] タブには、エミュレーター内で HoloLens OS を駆動するために使用されるシミュレートされたセンサーの現在の状態が表示されます。 [シミュレーション] タブの任意の値にカーソルを合わせると、その値を制御する方法を説明するヒントが表示されます。

[ルーム] タブ

エミュレーターは、シミュレートされた部屋からの空間マッピング メッシュの形式でワールド入力をシミュレートします。 このタブでは、既定の部屋ではなく、読み込む部屋を選択できます。

HoloLens エミュレーターの [Rooms] タブ

詳細については、「 シミュレートされたルーム 」を参照してください。

[アカウント] タブ

[アカウント] タブを使用すると、Microsoft アカウントでサインインするようにエミュレーターを構成できます。 これは、ユーザーがアカウントでサインインする必要がある API をテストする場合に便利です。 このページのチェック ボックスをオンにすると、ユーザーが初めて HoloLens を起動したときと同様に、エミュレーターの後で起動するとサインインするように求められます。

シミュレートされた部屋

シミュレートされた会議室は、複数の環境でアプリケーションをテストするのに役立ちます。 エミュレーターにはいくつかの部屋が付属しています。 エミュレーションをインストールすると、%ProgramFiles(x86)%\Windows Kits\10\Microsoft XDE\(version)\Plugins\Rooms に表示されます。 これらの部屋はすべて、HoloLens を使用して実際の環境でキャプチャされました。

  • DefaultRoom.xef - テレビ、コーヒー テーブル、ソファ 2 台が備わる小さなリビングルーム。 エミュレーターを起動すると、既定で読み込まれます。
  • ベッドルーム1.xef - デスク付きの小さなベッドルーム。
  • ベッドルーム 2.xef - クイーンサイズベッド、ドレッサー、ナイトスタンド、ウォークイン クローゼットが備わるベッドルーム。
  • GreatRoom.xef - リビングルーム、ダイニングテーブル、キッチンが備わる広いオープンスペースの素晴らしい客室です。
  • LivingRoom.xef - リビングルーム(暖炉、ソファ、肘掛け椅子、花瓶付きコーヒーテーブル付)

HoloLens (第 1 世代) の Windows デバイス ポータル の [シミュレーション] ページで、エミュレーターで使用する独自の会議室を記録することもできます。

エミュレーターでは、レンダリングするホログラムのみが表示されます。 ただし、ホログラムの背後にシミュレートされた部屋が表示されます。 これは、両方がブレンドされている実際の HoloLens とは対照的です。 HoloLens Emulator でシミュレートされたルームを表示する場合は、シーン内の空間マッピング メッシュをレンダリングするようにアプリケーションを更新する必要があります。

既知の問題

  • HoloLens 2 エミュレーターをアンインストールすると、ハード ディスク イメージ (Flash.vhdx) が Windows Kits\10\エミュレーション\HoloLens<build number> フォルダーのハード ドライブに残ることがあります。 このファイルは安全に削除できます。
  • ハードウェア グラフィックスアクセラレーションにより、AMD または Intel グラフィックスを使用する一部のシステムで Holographic アプリがクラッシュする可能性があります。 エミュレーターの [ツール] ウィンドウでハードウェア グラフィックス アクセラレータを無効にすると、この問題が回避されます。
  • 2020 年 7 月の時点で最新の Windows 更新プログラムをインストールした後、HoloLens Emulator (最初の Gen) でハードウェア グラフィックス アクセラレータを使用できなくなる可能性があります。 ハードウェア グラフィックス アクセラレータに必要な RemoteFX コンポーネントは非推奨となり、今後の Windows リリースで削除される予定です。 ハードウェア グラフィックス アクセラレータを再度有効にするには、 Enable-VMRemoteFXPhysicalVideoAdapter PowerShell コマンドレットを使用します。 詳細については、 Windows での RemoteFX サポートの廃止と削除に関するドキュメント を参照してください。

トラブルシューティング

エミュレーターのインストール中に" Visual Studio 2015 Update 1 および UWP ツール バージョン 1.2" が必要であることを示すエラー メッセージが表示される場合があります。 このエラーには、次の 3 つの原因が考えられます。

  • Visual Studio の最新バージョン (Visual Studio 2019、Visual Studio 2017、または Visual Studio 2015 Update 1 以降) がありません。 これを修正するには、Visual Studio の最新リリースをインストールします。
  • Visual Studio の最新バージョンはありますが、ユニバーサル Windows プラットフォーム (UWP) ツールはインストールされていません。 これは、Visual Studio のオプション機能です。 HoloLens (最初の Gen) の場合は、UWP Tools for Visual Studio 2015 または Visual Studio 2017 が必要です。

また、Windows の Pro/Enterprise/Education 以外の SKU または Hyper-V 機能が有効になっていない場合は、エミュレーターのインストール中にエラーが発生する場合があります。

  • 要件の完全なセットについては、上記の 「システム要件 」セクションを参照してください。
  • また、Hyper-V 機能がシステムで有効になっていることを確認します。

インストールが正常に完了したが、展開とデバッグのオプションとして HoloLens Emulator が表示されない場合:

  • Visual Studio プロジェクト構成が x86 (HoloLens first Gen)、x86、x64 (HoloLens 2 Emulator) に設定されています。
  • Visual Studio 2019 を使用している場合、プロジェクト構成のプラットフォーム ツールセットは v142 に設定されます。

インストールが正常に完了したが、Visual Studio で HoloLens エミュレーターを起動しようとするとエラーが表示される場合:

  • 管理者として Visual Studio を実行する
  • Visual Studio 2019 のみをインストールしたことがある場合は、HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Kits\Installed Roots のレジストリ値 "KitsRoot10" が 32 ビット Program Files フォルダー ("C:\Program Files (x86)\Windows Kits\10" など) を指していることを確認します。 インストールされていない場合は、HoloLens Emulator をアンインストールし、レジストリ値を 32 ビットの Program Files フォルダーに変更してから、HoloLens Emulator を再インストールします。 この問題は、Visual Studio 2019 16.0.3 で解決されています。

起動時にエミュレーターに "無効なバイト エンコード" エラー ダイアログが表示される場合:

  • %localappdata%\Microsoft\XDE\HCS 内のすべてのファイルを削除して、もう一度やり直してください。

Visual Studio のデバッグ ターゲット リストが空の場合 (たとえば、Start が唯一のオプションです)、上記のすべてのトラブルシューティング手順に従いました。

  • %localappdata%\Microsoft\VisualStudio\<installation id>\CoreCon の ConfigurationCache フォルダーを削除して、もう一度やり直してください。

エミュレーターの起動時にシステムがハングする場合は、エミュレーター グラフィックスのハードウェア アクセラレータを無効にします。

  • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\XDE\10.0 に "DisableGPU" という名前のレジストリ DWORD 値を作成し、その値を 1 に設定します。

Hololens2 Emulator がキーボードまたはマウスからの入力に応答しない場合は、VPN 接続を無効にしてみてください。

関連項目