AR Foundation 向け ARCore Extensions のスタートガイド

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

要件

AR Foundation 用の ARCore Extensions を使用して開発するには、次のものが必要です。

Android

ハードウェア

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

ソフトウェア

• Unity 2019.4.3f1 以降（Android ビルドサポート）
• AR Foundation 4.1.5 以降（ARCore Extensions for AR Foundation SDK で自動的にインストールされます）
• ARCore XR プラグイン 4.1.5 以降（ARCore Extensions for AR Foundation SDK で自動的にインストールされます）

iOS

ハードウェア

• ARKit 対応の ARCore 対応デバイス
• デバイスを開発マシンに接続するための USB ケーブル

ソフトウェア

• Unity 2019.4.3f1 以降（iOS ビルドサポートを含む）
• AR Foundation 4.1.5 以降（ARCore Extensions for AR Foundation SDK で自動的にインストールされます）
• ARKit XR プラグイン 4.1.5 以降（ARCore Extensions for AR Foundation SDK で自動的にインストールされます）
• Xcode 11.0 以降

ARCore Extensions パッケージをインストールする

AR Foundation 用の ARCore Extensions をインストールする手順は次のとおりです。

バンドルされた依存関係

1. 開発環境に AR Foundation がインストールされ、構成されていることを確認します。
2. 新しい Unity プロジェクトを開くか、作成します。
3. ターゲット ビルド プラットフォームを選択します。
   1. File メニューから Build Settings を選択します。
   2. 目的のターゲット プラットフォームに応じて、Android または iOS を選択します。
   3. [Switch Platform] をクリックします。

4. 最新の ARCore Extensions パッケージをインポートします。

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

   2. ボタンをクリックし、プルダウン メニューから Add package from git URL... オプションを選択します。
      

   3. テキスト フィールドに次の URL を貼り付けます。

      https://github.com/google-ar/arcore-unity-extensions.git
      

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

EDM4U なし

デフォルトでは、ARCore 拡張機能は追加の依存関係にバンドルされています。External Dependency Manager for Unity の異なるバージョンに依存する他のライブラリ（Firebase Analytics など）を使用すると、未定義の動作が発生し、依存元の動作が停止することがあります。

ライブラリのバージョニングの競合を避けるため、バンドルされた依存関係なしで ARCore 拡張機能をインストールします。

1. ARCore Extensions without EDM4U release と com.google.external-dependency-manager をダウンロードします。
2. UPM パッケージを .tgz ファイルとともにインポートする手順に沿って、次の順序でパッケージをインストールします。
   1. com.google.external-dependency-manager,
   2. ARCore 拡張機能（EDM4U なし）。

ARCore Extensions をインストールすると、Unity により必要な依存関係の適切なバージョンも自動的にインストールされます。

• AR Foundation
• ARCore XR Plugin（Android をターゲットとする場合に使用）
• ARKit XR Plugin（iOS をターゲットとする場合に使用）

これらの依存関係は、Package Manager > Package: In project ビューに表示されない場合があります。ただし、パッケージは Packages の下の Project ウィンドウで確認できます。

ARCore 拡張機能をセットアップする

AR Foundation 4.x

1. [Hierarchy] ペインで、右クリックして次のゲーム オブジェクトを追加します（まだ追加されていない場合）。

   • XR > AR Session
   • XR > AR Session Origin
   • XR > ARCore Extensions

2. Hierarchy ペインで、ARCore Extensions パッケージを選択します。

3. [Inspector] ペインの以下の各フィールドで、ターゲットの ボタンをクリックし、各フィールドを対応するゲーム オブジェクトに接続します。

   • Session: シーンの AR Session を使用します。
   • AR Session Origin: シーンの AR Session Origin を使用します。
   • Camera Manager: シーンの AR Camera を使用します。

4. 必要に応じて、Cloud Anchors とカメラ構成フィルタ用に次のアセットを作成して接続します。

   1. Project > Assets ペインで右クリックして、[Create > XR > ARCore Extensions Config] を選択します。

   2. Project > Assets ペインで右クリックして、[Create > XR > Camera Config Filter] を選択します。

   3. Hierarchy ペインで、ARCore Extensions パッケージを選択します。

   4. Inspector ペインの ARCore Extensions Config フィールドで、ターゲットの ボタンをクリックし、ARCoreExtensionsConfig アセットに接続します。

   5. Inspector ペインの Camera Config Filter フィールドで、ターゲットの ボタンをクリックし、ARCoreExtensionsCameraConfigFilter アセットに接続します。

      詳細については、Cloud Anchors デベロッパー ガイドとカメラの構成のガイドをご覧ください。

   6. 2020.3 より前のバージョンの Unity を使用している場合:

      • [Project Settings] > [Player] > [Android] > [Publishing Settings] > [Build] で [Custom Gradle Properties Template] を選択します。

上記の ARCore Extensions フィールドをすべて適切に接続すると、ARCore Extensions の Inspector ペインは次のようになります。

AR Foundation 5.x

1. [Hierarchy] ペインで、右クリックして次のゲーム オブジェクトを追加します（まだ追加されていない場合）。

   • XR > AR Session
   • XR > XR Origin (Mobile AR)
   • XR > ARCore Extensions

2. Hierarchy ペインで、ARCore Extensions パッケージを選択します。

3. [Inspector] ペインの以下の各フィールドで、ターゲットの ボタンをクリックし、各フィールドを対応するゲーム オブジェクトに接続します。

   • Session: シーンの AR Session を使用します。
   • XR Origin: シーンの XR Origin を使用します。
   • Camera Manager: シーンの AR Camera を使用します。

4. 必要に応じて、Cloud Anchors とカメラ構成フィルタ用に次のアセットを作成して接続します。

   1. Project > Assets ペインで右クリックして、[Create > XR > ARCore Extensions Config] を選択します。

   2. Project > Assets ペインで右クリックして、[Create > XR > Camera Config Filter] を選択します。

   3. Hierarchy ペインで、ARCore Extensions パッケージを選択します。

   4. Inspector ペインの ARCore Extensions Config フィールドで、ターゲットの ボタンをクリックし、ARCoreExtensionsConfig アセットに接続します。

   5. Inspector ペインの Camera Config Filter フィールドで、ターゲットの ボタンをクリックし、ARCoreExtensionsCameraConfigFilter アセットに接続します。

      詳細については、Cloud Anchors デベロッパー ガイドとカメラの構成のガイドをご覧ください。

   6. 2020.3 より前のバージョンの Unity を使用している場合:

      • [Project Settings] > [Player] > [Android] > [Publishing Settings] > [Build] で [Custom Gradle Properties Template] を選択します。

上記の ARCore Extensions フィールドをすべて適切に接続すると、ARCore Extensions の Inspector ペインは次のようになります。

プロパティの設定について詳しくは、Unity のプロパティの編集ガイドをご覧ください。

サンプル プロジェクト

AR Foundation 用の ARCore 拡張機能にバンドルされているサンプル プロジェクトは、独自のプロジェクトの構築を始めるために使用できます。

1. Window メニューから Package Manager を開き、ARCore Extensions パッケージを選択します。

2. Samples で、以下で説明するサンプル プロジェクトの Import をクリックします。

次のサンプル プロジェクトは、GitHub リポジトリからインポートされています。

• 地理空間（Android のみ） - 世界規模で AR エクスペリエンスを創出し、Google ストリートビューの対象領域にリモートでコンテンツを添付します。詳細については、Geospatial API の概要をご覧ください。

• PersistentCloudAnchors（Android および iOS） - 実際の場所に固定されたデジタル情報のインタラクティブなレイヤを使用して、現実世界に永続的な AR エクスペリエンスを作成します。また、さまざまなデバイスで複数のユーザーが時間の経過とともに共有できるエクスペリエンスをデザインします。詳細については、Cloud Anchors の概要をご覧ください。

次のステップ

AR Foundation 用の ARCore 拡張機能により、アプリで Cloud Anchors とカメラ構成を使用できるようになりました。

• Cloud Anchors デベロッパー ガイド
• カメラ構成ガイド