AR Foundation スタートガイド

Unity の AR Foundation は、 拡張現実エクスペリエンスを作成できるクロス プラットフォーム フレームワーク Android デバイスまたは iOS デバイス向けにビルドできます。追加の作業は必要ありません できます。フレームワークは Unity の AR Foundation パッケージから入手できます。

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

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

  • ARCore SDK for 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 プラグイン パッケージを使用すると、Android デバイス向けの拡張現実アプリをビルドできます。 アプリが Unity プロジェクトにインストールされていない場合は、次の手順に沿ってインストールしてください。 Android デバイスが対象です。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 デバイス向けの拡張現実アプリを作成できます。 アプリが Unity プロジェクトにインストールされていない場合は、次の手順に沿ってインストールしてください。 iOS デバイスをターゲットとする。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 Foundation 4.x

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

  • AR Session Origin: AR 座標を Unity に変換します 世界座標。

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

新しい AR ゲーム オブジェクトをシーンに追加します。 Hierarchy ペインに移動し、[XR] を選択します。追加 新しい AR Session と新しい AR Session Origin 作成します。

AR Foundation 5.x

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

  • XR Origin: AR 座標を Unity に変換します 世界座標。

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

新しい AR ゲーム オブジェクトをシーンに追加します。 Hierarchy ペインに移動し、[XR] を選択します。追加 新しい AR Session と新しい XR Origin 作成します。

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

Android

  1. File > Build Settings に移動して Build Settings クリックします。
  2. [Platform] で [Android] を選択し、[Switch Platform] をクリックします。
  3. [Player Settings] をクリックします。

  4. 次の変更を適用します。

    Player Settings > … 値
    Other Settings > Rendering Auto Graphics API のチェックボックスをオフにします。
    Graphics APIs の下に Vulkan が表示されている場合は、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 Optional アプリを作成する場合は、Android API Level 19 or higher を指定します。
    Other Settings > Scripting Backend Mono ではなく IL2CPP を選択して、次のステップで ARM64 サポートを有効にできるようにします。

    開発中:

    • Mono + 32 ビット（ARMv7）を使用する
    • FAT（32-bit + 64-bit）ARCore APK をインストール

    Google Play ストアに発送する場合:

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

iOS

  1. File > Build Settings に移動して Build Settings クリックします。
  2. [Platform] で [iOS] を選択し、[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

次のステップ