ダイレクト プレビューを使用すると、Android XR デバイスのライブデータを使用して、Unreal Editor 内で複雑なインタラクションを直接テストして反復処理できます。Direct Preview を使用すると、ホストマシンがコンテンツをレンダリングしてデバッグし、ビジュアル ビューポートを物理的な Android XR デバイスに直接ストリーミングします。また、サポートされている OpenXR 拡張機能をリアルタイムでホストにストリーミングします。
このガイドに沿って、Unreal Engine でプロジェクトのダイレクト プレビューを設定します。
前提条件
始める前に、開発環境が次の要件を満たしていることを確認してください。
- Unreal Engine のバージョン: Unreal Engine 5.6.x または 5.8.x。
- プロジェクトの設定: Unreal Engine プロジェクトの設定ガイドのすべての手順を完了します。
- Android XR エンジンハブ: Android XR エンジンハブ ガイドのスタートガイド セクションの手順をすべて完了し、Direct Preview 用にホストマシンをインストールして構成します。
ハードウェア:
- Windows 11 を実行しているホストマシンを使用します。
- Vulkan 動画エンコードをサポートする最新のグラフィック カードを使用します。
Android XR プラグインをセットアップする
必要な Android XR プラグインを使用して Unreal Engine をセットアップします。
Android XR Extensions for Unreal Engine クイックスタート ガイドの手順に沿って操作します。
後で新しいプロジェクトを作成する場合や、Direct Preview で使用したことがないプロジェクトを開く場合は、同じ手順を繰り返します。
各プロジェクトで、プロジェクトにベンダー プラグイン フォルダへのシンボリック リンクがあることを確認します。
プロジェクトの構成
Direct Preview ストリーミングのプロジェクト設定を構成します。
- プロジェクト設定 > Platforms > Windows に移動します。
- [RHI] を [Vulkan] に設定します。
- [Edit] > [Plugins] に移動します。
- AndroidXRStreaming プラグインを有効にします。
- [Edit] > [プロジェクト設定] > [Description] に移動します。
- [Start In VR] を有効にします。
ストリーミング ランタイムを有効にする
プロジェクトで AndroidXRStreaming プラグインが有効になったので、Android XR Streaming ランタイムが存在するかどうかを確認します。
- [Project Settings] > [Plugins] > [AndroidXRStreaming] に移動します。
[Enable AndroidXR Streaming] をクリックします。
Unreal Engine を再起動して、これらの変更を適用します。
ストリーミング クライアントを構成する
プロジェクトのさまざまなオプションを使用してストリーミング クライアントを構成します。
- [Project Settings] > [Plugins] に移動します。
[AndroidXRStreamingClient] セクションで、次の各オプションを確認し、プロジェクトのニーズに合わせて有効または無効にします。
- Auto Start Client On Preview: 有効にすると、エディタで [Start VR Preview] をクリックしたときに、選択した有効なデバイスでプレビュー クライアント アプリが起動します。
- Auto Stop Client On Preview: 有効にすると、エディタからの VR プレビューが停止したときにプレビュー クライアントが終了します。
- Auto Select Compatible Device: 有効にすると、デバイスを検索するときに、マシンに接続されている最初の互換性のあるデバイスが自動的に選択されます。
- エラー ダイアログを表示する: 有効にすると、追加のエラー ダイアログが表示されます（たとえば、クライアント デバイスを選択せずに VR プレビューを開始しようとすると、エラー ダイアログが表示されます）。これらのダイアログを非表示にするには、このオプションを無効にします。
- 更新: 有効にすると、[更新] ボタンで接続されているデバイスを検索し、互換性のあるデバイスを一覧表示します（Android XR エンジンハブに Direct Preview クライアント アプリが存在するかどうかで判断されます）。
直接プレビューを開始
Unreal Engine から直接ストリーミングするには、Direct Preview を開始します。
高品質の USB-C ケーブルを使用して、Android XR デバイスをホストマシンに接続します。
このデバイスを Direct Preview で使用したことがない場合は、ゲームエンジンから Direct Preview を開始する前に、Android XR エンジンハブでデバイスを接続して Direct Preview 用に構成します。
Unreal Editor で、[Play level in VR] をクリックします。Direct Preview を開始するときは、通常の [Play in Editor] オプションを使用しないでください。