Table of Contents

Unity-Anwendungen von EasyAR Sense Unity Plugin 4.2 und älteren Versionen migrieren

Ab Version 4.3 wird das Unity-Plugin über den Unity Package Manager verteilt und verwaltet, und die Struktur des Plugin-Pakets wurde deutlich angepasst. Daher sind beim Upgrade von 4.2 oder älter auf 4.3 oder neuer einige zusätzliche Schritte erforderlich.

Migrationsschritte

Beim Upgrade von Version 4.2 oder älter müssen Sie:

  1. Alle Dateien des alten Plugins löschen. Diese Dateien können in den Ordnern Assets/EasyAR, Assets/Plugins, Assets/Samples und Assets/StreamingAssets vorhanden sein.
  2. Dann die neue Version über Unitys Package Manager window importieren.
  3. Szenen und Code gemäß den untenstehenden Migrationsleitfäden der einzelnen Versionen aktualisieren.

Migration auf 4000 und neuere Versionen

Für die Migration auf 4000 und neuere Versionen sind die folgenden Änderungen erforderlich.

Lesen Sie AR session erstellen und konfigurieren, um die Szenenstruktur neu zu erstellen.

Zugehörige Änderungen:

  • prefab wurde entfernt.
  • VIOCameraDeviceUnion wurde entfernt.

Um AR Foundation zu verwenden, lesen Sie AR Foundation in einem EasyAR-Projekt aktivieren.

Zugehörige Änderungen:

  • AR Foundation-Unterstützung wurde neu implementiert.

Sie können EasyAR nicht auf XREAL X- und XREAL Light-Geräten verwenden. Es wird empfohlen, auf XREAL Air2 Ultra umzusteigen.

Zugehörige Änderungen:

  • Nreal/XREAL X und Nreal/XREAL Light werden nicht mehr unterstützt.
  • XREAL-Unterstützung ist in EasyAR Sense integriert und unterstützt XREAL Air2 Ultra.

Lesen Sie Migration auf 4000 für die nächsten Migrationsarbeiten.

Version 4000 enthält im Vergleich zu 4.x weitere Änderungen.

Migration auf Version 4.6

Warnung

Version 4.6 wird nicht mehr gewartet. Es wird empfohlen, direkt auf 4000 zu aktualisieren oder eine neuere Version zu verwenden. Die ausführliche Unity-Entwicklungsdokumentation auf der EasyAR-Website ist für Version 4000 und höher vorbereitet.

Für die Migration auf Version 4.6 sind die folgenden Änderungen erforderlich.

Es wird empfohlen, die Beispiele der Version 4.6 zu lesen, um die neue Szenenstruktur zu verstehen, und die zugehörigen Komponenten neu zu erstellen.

Zugehörige Änderungen:

  • prefab wurde entfernt.
  • VIOCameraDeviceUnion wurde entfernt.
  • AR Foundation-Unterstützung wurde in ein unabhängiges package aufgeteilt.

Wenn AR Foundation nicht benötigt wird, können Sie den Knoten AR Foundation unter AR Session in der Szene und die Verwendung von ARFoundationFrameSource im Code entfernen.

Zugehörige Änderungen:

  • AR Foundation-Unterstützung wurde in ein unabhängiges package aufgeteilt.

Wenn Nreal nicht benötigt wird, können Sie den Knoten Nreal unter AR Session in der Szene und die Verwendung von NrealFrameSource im Code entfernen. Bei Verwendung von Nreal muss kein virtuelles package mehr erstellt werden.

Zugehörige Änderungen:

  • Nreal-Unterstützung wurde in ein unabhängiges package aufgeteilt.

Es wird empfohlen, die API-Dokumentation in den Skripten und die Beispiele der Version 4.6 zu lesen, um API-Änderungen und Verwendung zu verstehen und entsprechende Anpassungen vorzunehmen.

Zugehörige Änderungen:

  • Einige andere Skript-APIs haben sich ebenfalls geändert.
  • Einige öffentliche Methoden sind in XML-Kommentaren als internal markiert. Diese APIs sollten vermieden werden. Sie wurden in Version 4000 entfernt.

Migration auf Version 4.4

Warnung

Version 4.4 wird nicht mehr gewartet. Es wird empfohlen, direkt auf 4000 zu aktualisieren oder eine neuere Version zu verwenden. Die ausführliche Unity-Entwicklungsdokumentation auf der EasyAR-Website ist für Version 4000 und höher vorbereitet.

Bei der Migration auf Version 4.4 müssen Sie die folgenden Änderungen beachten.

Entfernen Sie Verweise auf prefabs innerhalb des Plugin-Pakets so weit wie möglich. Wenn Sie diese prefabs weiterhin verwenden, werden Warnprotokolle angezeigt, und diese Protokolle enthalten kurze Hinweise, wie sie im neuen Plugin ersetzt werden können. Es wird empfohlen, die Beispiele der Version 4.4 zu lesen, um die neue Szenenstruktur zu verstehen.

Zugehörige Änderungen:

  • prefab wurde als veraltet markiert und in Version 4.6 entfernt.

Entfernen Sie die Verwendung von VIOCameraDeviceUnion. Wenn Sie diese Komponente weiterhin verwenden, werden Warnprotokolle angezeigt, und diese Protokolle enthalten kurze Hinweise, wie sie im neuen Plugin ersetzt werden kann. Es wird empfohlen, die Beispiele der Version 4.4 zu lesen, um die neue Szenenstruktur zu verstehen.

Zugehörige Änderungen:

  • VIOCameraDeviceUnion wurde als veraltet markiert und in Version 4.6 entfernt.

Es wird empfohlen, die API-Dokumentation in den Skripten und die Beispiele der Version 4.4 zu lesen, um API-Änderungen und Verwendung zu verstehen und entsprechende Anpassungen vorzunehmen.

Zugehörige Änderungen:

  • Einige andere Skript-APIs haben sich ebenfalls geändert.
  • Einige öffentliche Methoden sind in XML-Kommentaren als internal markiert. Diese APIs sollten vermieden werden. Sie wurden in Version 4000 entfernt.