Unreal Engine プロジェクトの設定

対象となる XR デバイス
このガイダンスは、次のようなタイプの XR デバイス向けのエクスペリエンスを構築する際に役立ちます。
XR デバイスのタイプについて →
XR ヘッドセット
有線 XR グラス
XR デバイスのタイプについて →

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

前提条件

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

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

    1. Epic Games Launcher から、Unreal Engine のバージョン 5.6.x または 5.8.x をインストールします。

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

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

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

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

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

  1. Epic Games Launcher を開きます。

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

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

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

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

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

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

    • ANDROID_HOME
    • JAVA_HOME
    • NDK_ROOT

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

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

  1. Unreal Engine（バージョン 5.6.x または 5.8.x）を起動します。
  2. [New Project Categories] で、[バーチャル リアリティ] テンプレートを選択します。
  3. [Project Defaults] メニューで、[Target Platform] を [Mobile] に設定します。
  4. [Quality Preset] を [Scalable] に設定して、モバイル XR ハードウェアで最適なパフォーマンスを実現します。
  5. プロジェクト名を選択し、[作成] をクリックします。

Android の設定を構成する

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

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

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

    Vulkan は、Android XR 向けの推奨される高パフォーマンスのグラフィック API です。

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

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

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

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

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

  3. [Default Settings] セクションで、[Anti-Aliasing Method] を [MSAA] に設定します。

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

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

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

    1. [モバイル HDR] をオフにします。

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

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

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

関連情報

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