AR Foundation バージョン 5.x（ベータ版）へのアップデート

注意: ARCore Extensions for Unity の AR Foundation は AR Foundation バージョン 5.x と互換性がありますが、既存のプロジェクトを移行する場合は、このドキュメントで説明している手順よりも多くの手順が必要になる場合があります。このドキュメントは参考用として利用できますが、現在、バージョン 5.x と 6.x のサポートを改善した新しいバージョンを準備しています。

Unity の AR Foundation の ARCore Extensions は、AR Foundation のバージョン 4.x とバージョン 5.x の両方をサポートしています。既存の AR プロジェクトを AR Foundation 4.x から AR Foundation 5.x にアップグレードするには、次の手順を行います。

1. Unity 2021.x 以前の場合のみ:
   一部の Unity パッケージは、特定の Unity エディタのバージョンにバインドされています。特定の Unity エディタのバージョンで AR Foundation 5.x に更新するには、Unity プロジェクトのパッケージ マニフェストの編集が必要になる場合があります。詳細については、Unity 2021 で AR Foundation 5.0 にアクセスするをご覧ください。

   以下のパッケージについて、Packages/manifest.json にそのバージョンが含まれていることを確認します。

   "dependencies": {
     -- other dependencies --
     "com.unity.xr.arcore": "5.0.5",
     "com.unity.xr.arfoundation": "5.0.5",
     "com.unity.xr.arkit": "5.0.5",
     -- other dependencies --
   }
   

2. Unity の AR Foundation の ARCore Extensions は、ARCORE_USE_ARF_5 カスタム スクリプト シンボルを使用して、バージョンの互換性を判断します。AR Foundation 5.x との互換性を確保するために、ARCORE_USE_ARF_5 カスタム スクリプト シンボルを追加します。

   1. [編集] > [プロジェクトの設定] > [プレーヤー] > [その他の設定] で、[スクリプトのコンパイル] まで下にスクロールします。
   2. [+] ボタンを使用して [ARCORE_USE_ARF_5] を追加します。
   3. [適用] を選択します。

3. AR Foundation 5.x は、TrackedPoseDriver に依存しているため、Input System パッケージが必要です。ARCore 拡張機能のサンプルシーンには、以前の入力モジュールが必要です。

   入力システム パッケージと古い入力マネージャーの両方をサポートするには、[Project Settings] > [Player] > [Other Settings] で、[Active Input Handling] を [Both] に設定します。

4. Unity の AR Foundation のアップグレードおよび移行ガイドに記載されている他の手順に沿って操作してください。