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

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

要件

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

Android

ハードウェア

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

ソフトウェア

• Android ビルドサポート付きの Unity 2019.4.3f1 以降
• AR Foundation 4.1.5 以降（ARCore Extensions for AR Foundation SDK とともに自動的にインストールされます）
• ARCore XR Plugin 4.1.5 以降（AR Foundation SDK 用 ARCore 拡張機能とともに自動的にインストールされます）

iOS

ハードウェア

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

ソフトウェア

• iOS ビルドサポート付きの Unity 2019.4.3f1 以降
• AR Foundation 4.1.5 以降（ARCore Extensions for AR Foundation SDK とともに自動的にインストールされます）
• ARKit XR Plugin 4.1.5 以降（AR Foundation SDK 用 ARCore Extensions とともに自動的にインストールされます）
• 16.0 以降の Xcode

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

AR Foundation 用 ARCore 拡張機能は、AR Foundation バージョン 4 と 5 をサポートしています。インストール手順は AR Foundation のバージョンによって異なります。

AR Foundation のバージョンを確認する手順は次のとおりです。

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

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

   

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

   

4. インストールされている AR Foundation のバージョンが表示されます。

インストールされている AR Foundation のバージョンを選択します。

<ph type="x-smartling-placeholder"></ph> AR Foundation 4.x AR Foundation 5.x

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

バンドルされた依存関係

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#arf5
      

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

EDM4U なし

デフォルトでは、ARCore Extensions は追加の依存関係とバンドルされています。別のバージョンの External Dependency Manager for Unity に依存する他のライブラリ（Firebase 向け Google アナリティクス など）を使用すると、未定義の動作が発生し、依存関係が正しく機能しなくなる可能性があります。

ライブラリのバージョンの競合を避けるため、依存関係をバンドルせずに ARCore Extensions をインストールします。

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

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

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

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

ARCore Extensions を設定する

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. Unity バージョン 2020.3 より前のバージョンを使用している場合:

      • [Project Settings]（プロジェクト設定）> [Player]（プレーヤー）> [Android] > [Publishing Settings]（公開設定）> [Build]（ビルド）で、[Custom Gradle Properties Template]（カスタム Gradle プロパティ テンプレート）を選択します。

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

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

サンプル プロジェクト

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

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

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

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

• Geospatial（Android のみ）- グローバル規模で AR エクスペリエンスを作成し、Google ストリートビューがカバーする任意のエリアにコンテンツをリモートで添付します。詳しくは、Geospatial API の概要をご覧ください。

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

次のステップ

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

• Cloud Anchors デベロッパー ガイド
• カメラの設定ガイド