Unreal でのストリーミング

  • [アーティクル]
  • 適用対象:
    HoloLens, HoloLens 2

"ストリーミング" は "Holographic Remoting" と呼ばれることもあります。詳細については、「Holographic Remoting の概要」を参照してください。

PC から HoloLens にストリーミングを行うことには、次の 2 つの大きな利点があります。

  • 複合現実アプリで PC の演算性能を活用できる。
  • 開発のイテレーション時間を短縮できる。

最初に、Holographic Remoting Player を HoloLens デバイスにダウンロードする必要があります。 Holographic Remoting Player を使用すると、アプリで次のソースから HoloLens 上のリモート処理プレーヤーに直接ストリーミングできるようになります。

  • Unreal Engine エディター
  • パッケージ化された Windows 実行可能ファイル

ストリーミング時には、アプリケーションをデバイス上で実行する場合と同じ HoloLens の機能をほぼすべて利用できます。 これには、ハンド ジョイント トラッキング (HoloLens 2 を使用している場合)、空間マッピング、空間アンカーなどが含まれます。ただし、こちらの一覧に記載されている機能は含まれません。

注意

  • ストリーミング品質は、ユーザーの Wi-Fi ネットワークの強度に大きく依存します。
  • Holographic Remoting Player では、すべての機能が自動的に有効になります。 ユーザーのアクセス許可が必要な機能 (例: 視線追跡) がストリーミングでは機能しているものの、デバイスでの実行では機能していない場合、プロジェクト設定で適切な機能を有効にしていることをご確認ください。

ストリーミングの制限事項

ストリーミングには、ハンド メッシュ、HoloLens カメラ、およびシステム キーボードを使用できません。 ストリーミングされたアプリの音声入力は、ストリーミング元の PC のマイクを介して取得できることに注意してください。

OpenXR

OpenXR で実行されている Unreal 4.26 では、Holographic Remoting Player のバージョン 2.4.0 以降へのストリーミングがサポートされています。 Holographic Remoting での最新の機能サポートについては、バージョン履歴とトラブルシューティングに関するページを参照してください。

デバイス サポート

ソース HoloLens 第 1 世代 HoloLens 2 イマーシブ ヘッドセット
Unreal エディター ✔️ ✔️ ✔️
Windows パッケージ ❌ ✔️ ✔️

注意

Holographic Remoting バージョン 2.2.0 以降では、Windows Mixed Reality を実行している Windows PC でもストリーミングを使用できます。

Unreal エディターからのストリーミング

開発者にとって、Unreal エディターから HoloLens デバイスへのストリーミングには、テスト時に大きなメリットがあります。更新プログラムをテストする前に、アプリのビルドとデプロイを待機する必要がなくなるからです。

エディターからのストリーミングの詳細な手順は、チュートリアル シリーズでわかります。

パッケージ化された Windows 実行可能ファイルからのストリーミング

Unreal 4.25.1 以降では、パッケージ化された Windows 実行可能ファイルから HoloLens 2 デバイスにアプリをストリーミングできます。

  1. エディター メニューで、[ファイル] [パッケージ プロジェクト] > [Windows] の順に移動します。

    • パッケージを保存する場所を選択し、 [Select Folder](フォルダーの選択) を選択します。

  2. パッケージのビルドが完了したら、HoloLens 2 で Holographic Remoting Player を開き、IP アドレスをメモします。

  3. Holographic Remoting Player を開いたままにして、コマンド ライン プロンプトで次を実行します。

    • cd を実行し、パッケージを保存したローカル ディレクトリに移動します。
    • 次のコマンドを入力します。<App Name>.exe -vr -HoloLensRemoting=<IP Address>

注意

プロジェクト設定に含まれるアプリケーション名が、Windows パッケージを作成するために自動的に使用されます。 何らかの理由でこれらが異なる場合は、コマンド プロンプトで Windows 実行可能ファイル名を使用します。

注意

パッケージ化された実行可能ファイルからのストリーミング時に視線追跡が機能しない場合、PC でサポートされている視線トラッカーを使用してその他のプラグインを無効にするか (例: Magic Leap)、関連する視線追跡引数を使用してコマンド ラインからアプリケーションを実行します (「コマンド ライン オプション」を参照)。

Enter キーを押すと、アプリケーションのストリーミングが開始します。

コマンド ライン オプション

Unreal Engine 4.26 以降の各プラットフォームからストリーミングする場合のその他のコマンド ライン オプションを次の表に示します。

オプション 説明
-HoloLensRemoting=<IP address:port> 接続先の HoloLens 2 デバイスの IP アドレス (およびオプションのポート) を取得します。 ポートが指定されていない場合、既定値は 8265 です。
-RemotingBitrate=<bitrate> (省略可能) 既定値は 8000 です。 最大ネットワーク転送速度 (kb/秒)。
-HoloLensRemotingListen (省略可能) リッスン サーバーを起動します
-HoloLensRemotingListenPort=<port> (省略可能) リッスンするポートを取得します。 HoloLens デバイスから PC または VM に接続するために使用されます。
-HoloLens1Remoting=<IP address> (4.26 では非推奨) 接続先の HoloLens 1 デバイスの IP アドレスを取得します
-eyetracking=WindowsMixedRealityEyeTracker (省略可能) Windows Mixed Reality 視線トラッカーを使用します

関連項目