EasyAR Sense Unity Plugin 4.2 以前のバージョンからの Unity アプリケーションの移行

バージョン 4.3 以降、Unity プラグインは Unity Package Manager を介した配布と管理に変更され、プラグインパッケージの構造も大幅に変更されました。したがって、4.2 以前のバージョンから 4.3 以降にアップグレードする場合、追加の手順が必要です。

移行の手順

4.2 以前のバージョンからアップグレードする場合、以下が必要です:

古いバージョンのプラグインの全ファイルを削除します。これらのファイルは Assets/EasyAR、Assets/Plugins、Assets/Samples、Assets/StreamingAssets フォルダ内に存在する可能性があります。
次に、Unity の Package Manager window を使用して新しいバージョンをインポートします。
以下の各バージョンの移行ガイドに従って、シーンとコードを更新します。

バージョン 4000 以降への移行

バージョン 4000 以降への移行には、以下の変更が必要です。

シーン構造を再作成するには、AR session の作成と設定を参照してください。

関連する変更:

prefab は削除されました。

VIOCameraDeviceUnion は削除されました。

AR Foundation を使用するには、EasyAR プロジェクトで AR Foundation を有効にするを参照して AR Foundation を使用してください。

関連する変更:

AR Foundation サポートが再実装されました。

XREAL X および XREAL Light デバイスでは EasyAR を使用できません。XREAL Air2 Ultra への切り替えを推奨します。

関連する変更:

Nreal/XREAL X および Nreal/XREAL Light のサポートは終了しました。

XREAL サポートが EasyAR Sense に組み込まれ、XREAL Air2 Ultra をサポートします。

次の移行作業を行うには、バージョン 4000 への移行を参照してください。

バージョン 4000 には 4.x と比較してさらなる変更点があります。

バージョン 4.6 への移行

警告

バージョン 4.6 はメンテナンスされなくなりました。直接バージョン 4000 へアップグレードするか、またはそれ以降のバージョンを使用することを強く推奨します。EasyAR ウェブサイトの包括的な Unity 開発ドキュメントは、バージョン 4000 以降を対象としています。

バージョン 4.6 への移行には、以下の変更が必要です。

新しいシーン構造についてはバージョン 4.6 のサンプルを参照し、関連コンポーネントを再作成することを推奨します。

関連する変更:

prefab は削除されました。

VIOCameraDeviceUnion は削除されました。

AR Foundation サポートは独立したパッケージに分離されました。

AR Foundation を使用しない場合は、シーン内の AR Session 下にある AR Foundation ノードと、コード内での ARFoundationFrameSource の使用を削除できます。

関連する変更:

AR Foundation サポートは独立したパッケージに分離されました。

Nreal を使用しない場合は、シーン内の AR Session 下にある Nreal ノードと、コード内での NrealFrameSource の使用を削除できます。Nreal を使用する際に仮想パッケージを作成する必要はなくなりました。

関連する変更:

Nreal サポートは独立したパッケージに分離されました。

インターフェースの変更点や使用方法については、スクリプト内のインターフェースドキュメントとバージョン 4.6 のサンプルを参照し、適宜調整することを推奨します。

関連する変更:

その他のスクリプトインターフェースにも変更があります。

パブリックメソッドの XML コメントで internal とマークされているものがあります。これらのインターフェースは使用を避け、バージョン 4000 で削除されています。

バージョン 4.4 への移行

警告

バージョン 4.4 はメンテナンスされなくなりました。直接バージョン 4000 へアップグレードするか、またはそれ以降のバージョンを使用することを強く推奨します。EasyAR ウェブサイトの包括的な Unity 開発ドキュメントは、バージョン 4000 以降を対象としています。

バージョン 4.4 への移行では、以下の変更点に注意する必要があります。

プラグインパッケージ内の prefab への参照は可能な限り削除する必要があります。これらの prefab を引き続き使用すると警告ログが表示され、そのログには新しいプラグインでの代替方法に関する簡単な指示が含まれています。新しいシーン構造については、バージョン 4.4 のサンプルを参照することを推奨します。

関連する変更:

prefab は非推奨 (obsolete) とマークされ、バージョン 4.6 で削除されました。

VIOCameraDeviceUnion の使用を削除してください。このコンポーネントを引き続き使用すると警告ログが表示され、そのログには新しいプラグインでの代替方法に関する簡単な指示が含まれています。新しいシーン構造については、バージョン 4.4 のサンプルを参照することを推奨します。

関連する変更:

VIOCameraDeviceUnion は非推奨 (obsolete) とマークされ、バージョン 4.6 で削除されました。

インターフェースの変更点や使用方法については、スクリプト内のインターフェースドキュメントとバージョン 4.4 のサンプルを参照し、適宜調整することを推奨します。