Unity プロジェクトの設定

このガイドでは、Android XR 向けの Unity アプリケーションを開発する際に推奨されるエディタのバージョン、グラフィック設定、URP 設定、Android プロジェクト設定について詳しく説明します。

前提条件

Unity で開発するには、Unity Hub をダウンロードしてインストールする必要があります。

Unity Editor と Android Build Support の バージョン 6000.0.23f1 以降をインストールします。これには以下が含まれます。

  • OpenJDK
  • Android SDK
  • Android NDK ツール

レンダリング エンジンを選択する

Android XR アプリのレンダリングには、Vulkan Graphics API を使用することをおすすめします。グラフィック API として Vulkan を選択する手順は次のとおりです。

  1. Unity で、[Edit] > [Project Settings] > [Player] に移動します。
  2. [Android] タブを選択し、[その他の設定 > レンダリング] に移動します。
  3. [Auto Graphics API] が有効になっている場合は、この設定を無効にして [Graphics APIs] セクションを表示します。
  4. [Graphics APIs] セクションで、[追加 (+)] ボタンを選択し、プルダウンから [Vulkan] を選択します。

    UI でグラフィック API の設定を変更する方法の例

  5. ハンドル(=)を使用してグラフィック API の順序を変更し、Vulkan が最初に表示されるようにします。

  6. 必要に応じて、他の Graphics API を選択し、[削除](-)ボタンをクリックして削除します。

ユニバーサル レンダリング パイプライン

Android XR は、Universal Render Pipeline(URP)に対応しています。パススルーを使用する場合は、Android XR で最適なパススルー パフォーマンスを得るために、デフォルトの URP 設定を更新する必要があります。

次の表に、Unity で推奨される URP 設定を示します。以降のセクションで詳しく説明します。

設定

場所

推奨値

HDR

ユニバーサル レンダリング パイプライン アセット

無効

後処理

ユニバーサル レンダラ データ

無効

Universal Render Pipeline アセットの設定

Android XR 用にユニバーサル レンダリング パイプライン アセットを最適化する手順は次のとおりです。

  1. プロジェクトの ユニバーサル レンダリング パイプライン アセットを見つけます。1 つの方法は、[プロジェクト] ウィンドウの検索バーに t:UniversalRenderPipelineAsset と入力することです。

  2. [画質] で [HDR] を無効にします。

    推奨設定が適用された Universal Render Pipeline アセット

ユニバーサル レンダラ データの設定

Android XR 用にユニバーサル レンダラ データを最適化する手順は次のとおりです。

  1. プロジェクトの ユニバーサル レンダラ データアセットを見つけます。たとえば、[プロジェクト] ウィンドウの検索バーに t:UniversalRendererData と入力します。

  2. [Inspector] の [Post-processing] ヘッダーで、[Enabled] のチェックボックスをオフにします。

    推奨設定とともに表示されるユニバーサル レンダラ データ

最小 Android API レベル

プロジェクトの最小 API レベルを 24 に設定します。これは OpenXR ローダーで必要です。そうしないと、ビルドが失敗する可能性があります。

最小 Android API レベルを設定する手順は次のとおりです。

  1. [編集] > [プロジェクト設定] > [プレーヤー] に移動します。
  2. [Android] タブを選択し、[その他の設定] を開きます。
  3. [識別] セクションの [最小 API レベル] で、24 以上を選択します。

アプリケーション エントリポイント

アプリケーション エントリポイントに次の設定を構成します。

  1. [編集] > [プロジェクト設定] > [プレーヤー] に移動します。
  2. [Android] タブを選択し、[その他の設定] を開きます。
  3. [Application Entry Point] セクションで、[GameActivity] がオンになっていて、[Activity] がオフになっていることを確認します。

ポップアップ ウィンドウ

ほとんどの Android XR アプリでは、システム権限リクエストなどのポップアップをレンダリングするために、サイズ変更可能なウィンドウが必要です。

ポップアップ ウィンドウが正しくレンダリングされるようにするには、次の手順に沿って操作してください。

  1. [編集] > [プロジェクト設定] > [プレーヤー] に移動します。
  2. [Android] タブを選択し、[Resizeable Activity] を有効にします。

関連ドキュメント