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 サポートは再実装されました。

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 Web サイトの詳細な Unity 開発ドキュメントは、4000 以降向けに用意されています。

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

新しいシーン構造を理解するために、バージョン 4.6 のサンプルを参照し、関連コンポーネントを作り直すことをお勧めします。

関連する変更:

prefab は削除されました。

VIOCameraDeviceUnion は削除されました。

AR Foundation サポートは独立した package に分割されました。

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

関連する変更:

AR Foundation サポートは独立した package に分割されました。

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

関連する変更:

Nreal サポートは独立した package に分割されました。

スクリプト内の API ドキュメントとバージョン 4.6 のサンプルを参照して API の変更と使い方を理解し、適切に調整することをお勧めします。

関連する変更:

その他の一部のスクリプト API も変更されています。

一部の public メソッドは XML コメントで internal とマークされています。これらの API の使用は避けてください。これらはバージョン 4000 で削除されています。

バージョン 4.4 へ移行する

警告

バージョン 4.4 はすでにメンテナンスされていません。直接 4000 へアップグレードするか、より新しいバージョンへアップグレードすることをお勧めします。EasyAR Web サイトの詳細な Unity 開発ドキュメントは、4000 以降向けに用意されています。

バージョン 4.4 へ移行する場合は、次の変更に注意してください。

プラグインパッケージ内の prefab への参照をできる限り削除する必要があります。これらの prefab を引き続き使用すると警告ログが表示され、そのログには新しいプラグインでの置き換え方法に関する簡単な案内が含まれます。新しいシーン構造を理解するために、バージョン 4.4 のサンプルを参照することをお勧めします。

関連する変更:

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

VIOCameraDeviceUnion の使用を削除してください。このコンポーネントを引き続き使用すると警告ログが表示され、そのログには新しいプラグインでの置き換え方法に関する簡単な案内が含まれます。新しいシーン構造を理解するために、バージョン 4.4 のサンプルを参照することをお勧めします。

関連する変更:

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

スクリプト内の API ドキュメントとバージョン 4.4 のサンプルを参照して API の変更と使い方を理解し、適切に調整することをお勧めします。