Unreal Engine のダイレクト プレビューを設定する

Direct Preview を使用すると、Android XR デバイスのライブデータを使用して、Unreal Editor 内で複雑なインタラクションを直接テストして反復処理できます。直接プレビューでは、ホストマシンがコンテンツをレンダリングしてデバッグし、視覚的なビューポートを物理的な Android XR デバイスに直接ストリーミングし、サポートされている OpenXR 拡張機能をリアルタイムでホストにストリーミングします。

このガイドに沿って、Unreal Engine でプロジェクトのダイレクト プレビューを設定します。

前提条件

始める前に、開発環境が次の要件を満たしていることを確認してください。

• Unreal Engine のバージョン: Unreal Engine 5.6.1 以降。
• プロジェクトの設定: Unreal Engine プロジェクトの設定ガイドの手順をすべて完了します。

• Android XR Engine Hub: Android XR Engine Hub ガイドのスタートガイド セクションのすべての手順を完了して、Direct Preview 用にホストマシンをインストールして構成します。

• ハードウェア:

  • Windows 11 を実行しているホストマシンを使用します。
  • Vulkan Video Encoding をサポートする最新のグラフィック カードを使用します。

Android XR プラグインを設定する

必要な Android XR プラグインを使用して Unreal Engine をセットアップします。

1. Unreal Engine 向け Android XR 拡張機能のクイック スタート ガイドの手順に沿って操作します。

   後で新しいプロジェクトを作成したり、ダイレクト プレビューで使用したことのないプロジェクトを開いたりする場合は、同じ手順をもう一度行ってください。

2. 各プロジェクトで、ベンダー プラグイン フォルダへのシンボリック リンクがあることを確認します。

プロジェクトの構成

Direct Preview ストリーミングのプロジェクト設定を構成します。

1. [Project Settings] > [Platforms] > [Windows] に移動します。
2. RHI から Vulkan。
3. [編集] > [プラグイン] に移動します。
4. AndroidXRStreaming プラグインを有効にします。
5. [編集] > [プロジェクト設定] > [説明] に移動します。
6. [VR で開始] を有効にします。

ストリーミング ランタイムを有効にする

プロジェクトで AndroidXRStreaming プラグインが有効になったので、Android XR Streaming ランタイムが存在するかどうかを確認します。

1. [Project Settings] > [Plugins] > [AndroidXRStreaming] に移動します。

2. [AndroidXR ストリーミングを有効にする] をクリックします。

   

3. これらの変更を適用するには、Unreal Engine を再起動します。

ストリーミング クライアントを構成する

プロジェクトのさまざまなオプションを使用して、ストリーミング クライアントを構成します。

1. [Project Settings] > [Plugins] に移動します。

2. [AndroidXRStreamingClient] セクションで、次の各オプションを確認し、プロジェクトのニーズに合わせて有効または無効にします。

   • Auto Start Client On Preview: 有効にすると、エディタで [Start VR Preview] をクリックしたときに、有効な選択済みデバイスでプレビュー クライアント アプリが起動します。
   • Auto Stop Client On Preview: 有効にすると、エディタからの VR プレビューが停止したときにプレビュー クライアントを終了します。
   • Auto Select Compatible Device（互換性のあるデバイスを自動選択）: 有効にすると、デバイスを検索するときに、マシンに接続されている互換性のある最初のデバイスが自動的に選択されます。
   • エラー ダイアログを表示: 有効にすると、追加のエラー ダイアログが表示されます（たとえば、クライアント デバイスを選択せずに VR プレビューを開始しようとすると、エラー ダイアログが表示されます）。これらのダイアログを非表示にするには、このオプションを無効にします。
   • 更新: 有効にすると、[更新] ボタンで接続されているデバイスが検索され、互換性のあるデバイスが一覧表示されます（Android XR Engine Hub に Direct Preview クライアント アプリがあるかどうかで判断されます）。

直接プレビューを開始

Unreal Engine から直接ストリーミングするには、Direct Preview を開始します。

1. 高品質の USB-C ケーブルを使用して、Android XR デバイスをホストマシンに接続します。

2. このデバイスで Direct Preview を使用したことがない場合は、ゲームエンジンで Direct Preview を開始する前に、Android XR Engine Hub で Direct Preview 用にデバイスを接続して設定します。

3. Unreal Editor で [Play level in VR] をクリックします。ダイレクト プレビューを開始するときは、通常の [エディタで再生] オプションを使用しないでください。