AR Foundation スタートガイド

Unity の AR Foundation はクロス プラットフォーム フレームワークであり、拡張現実を一度作成すれば、Android または iOS デバイス向けに追加の変更を加えることなくビルドできます。このフレームワークは Unity の AR Foundation パッケージを通じて入手できます。

ARCore のオプションの AR Foundation の ARCore 拡張機能パッケージに機能が追加され、Cloud Anchors、カメラ構成フィルタ、録画と再生などの機能をアプリで使用できます。

既存のプロジェクトを移行またはアップグレードする

  • 既存のプロジェクトを(非推奨の)ARCore SDK for Unity から Unity の AR Foundation(必要な場合は ARCore Extensions)に移行するには、移行ガイドをご覧ください。
  • 以前のバージョンの AR Foundation から既存のプロジェクトをアップグレードするには、Unity のアップグレードおよび移行ガイドをご覧ください。

要件

ターゲット プラットフォームに応じて、AR Foundation パッケージには次のものが必要です。

Android

ハードウェア

  • ARCore 対応 Android デバイスまたはエミュレータ
  • デバイスを開発マシンに接続するための USB ケーブル

ソフトウェア

iOS

ハードウェア

ソフトウェア

AR Foundation をインストールする

AR Foundation Unity パッケージをインストールする手順は次のとおりです。

  1. 既存の Unity プロジェクトを開くか、新しい 3D プロジェクトを作成します。

  2. Window > Package Manager に移動します。

  3. Packages の横にある [Unity Registry] を選択します。

  4. 検索バーに「AR Foundation」と入力します。

  5. [Install] をクリックします。

プラットフォーム固有のプラグイン パッケージをインストールして有効にする

AR Foundation パッケージには、Unity デベロッパーが使用するためのインターフェースが用意されていますが、AR 機能自体は実装されていません。ターゲット デバイスで AR Foundation を使用するには、個別のパッケージをインストールし、プラットフォームごとに対応するプラグインを有効にする必要もあります。

Android

ARCore XR Plugin パッケージを使用すると、Android デバイス向けに拡張現実(AR)アプリを構築できます。アプリが Android デバイスをターゲットにしている場合は、次の手順に沿って Unity プロジェクトにインストールします。互換性の問題を回避するため、AR Foundation パッケージと同じバージョンを使用してください。

  1. プロジェクトで Window > Package Manager に移動します。

  2. Packages の横にある [Unity Registry] を選択します。

  3. 検索バーに「ARCore XR plugin」と入力します。

  4. [Install] をクリックします。

  5. Edit > Project Settings に移動します。XR Plug-in Management で [Android] タブを開き、ARCore を有効にします。

iOS

ARKit XR プラグインを使用すると、iOS デバイス用の拡張現実(AR)アプリを構築できます。アプリが iOS デバイスをターゲットにしている場合は、次の手順に沿って Unity プロジェクトにインストールします。互換性の問題を回避するため、AR Foundation パッケージと同じバージョンを使用してください。

  1. プロジェクトで Window > Package Manager に移動します。

  2. Packages の横にある [Unity Registry] を選択します。

  3. 検索バーに「ARKit XR plugin」と入力します。

  4. [Install] をクリックします。

  5. Edit > Project Settings に移動します。XR Plug-in Management で [iOS] タブを開き、ARKit を有効にします。

AR セッションを構成し、AR Foundation コンポーネントをシーンに追加する

モーション トラッキング、環境理解、ライティング推定などの AR プロセスを有効にするには、AR セッションが必要です。AR セッションをサポートするには、次のゲーム オブジェクトが必要です。

  • AR Session: AR エクスペリエンスのライフサイクルを制御します。

  • AR Session Origin: AR 座標を Unity ワールド座標に変換します。

新しいゲーム オブジェクトを追加する前に、デフォルトの Main Camera を削除します。これは、AR Session Origin の新しい AR Camera に置き換えられます。

新しい AR ゲーム オブジェクトをシーンに追加します。Hierarchy ペインを右クリックして XR を選択します。新しい AR Session と新しい AR Session Origin ゲーム オブジェクトを追加します。

プレーヤーの設定を構成する

Android

  1. File > Build Settings に移動して Build Settings ウィンドウを開きます。
  2. PlatformAndroid を選択し、[Switch Platform] をクリックします。
  3. [Player Settings] をクリックします。
  4. 次の変更を適用します。

    Player Settings > … 価値
    Other Settings > Rendering Auto Graphics API チェックボックスをオフにします。
    VulkanGraphics APIs に表示されている場合は、Vulkan が ARCore でまだサポートされていないため、削除します。
    Other Settings > Package Name Java パッケージ名形式を使用して一意のアプリ ID を作成します。
    たとえば、com.example.helloAR を使用します。
    Other Settings > Minimum API Level AR 必須アプリをビルドする場合は、Android 7.0 'Nougat' (API Level 24) or higher を指定します。
    AR オプション アプリを作成する場合は、Android API Level 19 or higher を指定します。
    Other Settings > Scripting Backend 次のステップで ARM64 のサポートを有効にできるように、Mono ではなく IL2CPP を選択します。

    開発中:

    • Mono + 32 ビット(ARMv7)を使用する
    • FAT(32 ビット + 64 ビット)ARCore APK をインストールする

    Play ストアに配送する場合:

    • IL2CPP
    • Play ストアの 64 ビット要件を満たすように 32 ビット(ARMv7)と 64 ビット(ARM64)の両方を有効にする
    • 省略可(2018.3 以降でサポート): Build SettingsAndroid App Bundles を有効にします。
    Other Settings > Target Architectures Google Play の 64 ビット要件を満たすには、ARM64(64 ビット ARM)を有効にします。32 ビットデバイスをサポートするには、ARMv7(32 ビット ARM)を有効のままにしておきます。

iOS

  1. File > Build Settings に移動して Build Settings ウィンドウを開きます。
  2. PlatformiOS を選択し、[Switch Platform] をクリックします。
  3. [Player Settings] をクリックします。
  4. 以下の設定を構成します。

    Player Settings > … 価値
    Other Settings > Bundle Identifier リバース DNS 形式でアプリの名前を追加します。
    たとえば、com.mycompany.myapp を使用します。
    Other Settings > Camera usage description AR の使用を説明する説明を入力します(例: ARKit)。
    Other Settings > Target minimum iOS version 11.0 以上
    Other Settings > Architecture ARM64

次のステップ