Unreal Engine プロジェクトの設定

このガイドでは、Android XR 向け Unreal Engine アプリを開発する際の推奨エンジン バージョン、必要な SDK、Android プロジェクト設定について詳しく説明します。

前提条件

Android XR 開発用に Unreal Engine を設定する前に、次のアプリケーションとツールをインストールする必要があります。

1. Epic Games Launcher をダウンロードしてインストールします。

   1. Epic Games Launcher から、Unreal Engine のバージョン 5.6.1 以降をインストールします。

2. C++ コードをビルドするようにシステムをセットアップします（たとえば、Windows の場合は Visual Studio 2022、macOS の場合は Xcode を使用します）。詳細については、Epic の C++ 開発環境の設定をご覧ください。

3. .NET 8.0 SDK をインストールします。

4. Android Studio（Panda 4 | 2025.3.4 パッチ 1 以降）をインストールします。

Android ビルドのサポートをインストールする

Android XR は特定の SDK バージョンに依存しているため、Unreal Engine とともに正しい Android ビルドツールをインストールする必要があります。

1. Epic Games Launcher を開きます。

2. インストールされている Engine バージョン（[Launch] ボタン）の横にあるプルダウン矢印をクリックし、[Options] をクリックします。

   1. インストール オプションまでスクロールし、[Android] を選択して、[適用] をクリックします。
   2. プロンプトが表示されたら、エンジンが必要とするファイル拡張子を登録できるようにします。

3. Java JDK 17 をインストールします。

4. Android Studio で、SDK Manager を使用して、Android XR サンプルに必要な次の特定のバージョンをインストールします。

   • SDK プラットフォーム: 34、35、36
   • NDK: 29.0.x
   • コマンドライン ツール（すべての項目）

5. Epic の高度な設定とトラブルシューティング ガイドに沿って、次のシステム環境変数を構成します。

   • ANDROID_HOME
   • JAVA_HOME
   • NDK_ROOT

Unreal XR プロジェクトを作成する

次に、新しいプロジェクトを作成し、必要な XR プラグインと入力で構成します。

1. Unreal Engine 5.6.1 を起動します。
2. [新しいプロジェクト カテゴリ] で、[バーチャル リアリティ] テンプレートを選択します。
3. [Project Defaults] メニューで、[Target Platform] を [Mobile] に設定します。
4. モバイル XR ハードウェアで最適なパフォーマンスを実現するため、[品質プリセット] を [スケーラブル] に設定します。
5. プロジェクト名を選択し、[作成] をクリックします。

Android の設定を構成する

プロジェクトを開いたら、次の手順に沿って Android XR に必要な Android API レベルとグラフィック設定を行います。

1. [編集] > [プロジェクト設定] に移動します。
2. [Platforms > Android] に移動します。
3. [Accept SDK License] ボタンが赤色でハイライト表示されている場合は、そのボタンをクリックします。
4. [APKPackaging] セクションで、次の操作を行います。
   • [最小 SDK バージョン] を 34 に設定します。
   • [Target SDK Version] を 34（以降）に設定します。

5. さらにスクロールして [ビルド] セクションに移動し、[Vulkan をサポート] を選択します。

   Vulkan は、Android XR 向けの推奨される高性能グラフィック API です。

レンダリング設定を構成する

Android XR に必要な高いフレームレートと視覚的な明瞭さを実現するには、最適化されたモバイル レンダリング パスを使用するように Unreal Engine を構成する必要もあります。

1. [Edit] > [Project Settings] に移動し、[Engine] > [Rendering] に移動します。

2. [Forward Renderer] セクションで、[Forward Shading] を選択します。

   フォワード レンダラは、デフォルトの遅延レンダラよりもモバイル VR で大幅に高速です。この機能を有効にするには、エディタの再起動とシェーダーのコンパイルが必要です。

3. [デフォルト設定] セクションで、[アンチエイリアシング方法] を [MSAA] に設定します。

4. [モバイル] セクションで、[モバイル MSAA] を [4x] に設定します。

   MSAA は、Temporal AA（TAA）によるぼかし効果なしで、VR に最も鮮明な結果を提供します。

5. [VR] セクションで、次の操作を行います。

   1. [モバイル HDR] をクリアします。

      モバイルでハイ ダイナミック レンジを無効にすると、後処理のオーバーヘッドが大幅に削減されます。

   2. [モバイル マルチビュー] を選択します。

      これにより、エンジンは両目を 1 回のパスでレンダリングできるようになり、CPU パフォーマンスが大幅に向上します。

関連情報

テンプレート プロジェクトを Android 搭載デバイスにデプロイする手順について詳しくは、Android 開発向けに Unreal Engine プロジェクトをセットアップするをご覧ください。