Table of Contents

Migration von unity-apps von easyar sense unity plugin 4.2 und älteren versionen

Ab Version 4.3 wird das Unity-Plugin über den Unity Package Manager verteilt und verwaltet, und die Paketstruktur wurde signifikant angepasst. Daher sind beim Upgrade von Version 4.2 oder niedriger auf Version 4.3 oder höher einige zusätzliche Schritte erforderlich.

Migrationsschritte

Beim Upgrade von Version 4.2 oder niedriger müssen Sie:

  1. Alle Dateien des alten Plugins löschen. Diese könnten sich in den Ordnern Assets/EasyAR, Assets/Plugins, Assets/Samples und Assets/StreamingAssets befinden.
  2. Anschließend die neue Version über das Package Manager-Fenster von Unity importieren.
  3. Szenen und Code gemäß den Migrationsleitfäden der einzelnen unten aufgeführten Versionen aktualisieren.

Migration zu version 4000 und neuer

Die Migration zu Version 4000 oder neuer erfordert die folgenden Änderungen.

Beziehen Sie sich auf Erstellen und Konfigurieren einer AR-Session, um die Szenenstruktur neu zu erstellen.

Relevante Änderungen:

  • Prefabs wurden entfernt.
  • VIOCameraDeviceUnion wurde entfernt.

Die Verwendung von AR Foundation erfordert die Anleitung Aktivieren von AR Foundation in EasyAR-Projekten.

Relevante Änderungen:

  • Die Unterstützung für AR Foundation wurde neu implementiert.

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

Relevante Änderungen:

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

Beziehen Sie sich auf Migration zu 4000 für die weiteren Migrationsschritte.

Version 4000 bringt im Vergleich zu 4.x weitere wesentliche Änderungen mit sich.

Migration zu version 4.6

Warnung

Version 4.6 wird nicht mehr gewartet. Es wird dringend empfohlen, direkt auf Version 4000 zu aktualisieren oder neuer. Die umfassende Unity-Entwicklerdokumentation auf der EasyAR-Website ist für Version 4000 und höher vorgesehen.

Die Migration zu Version 4.6 erfordert die folgenden Änderungen.

Es wird empfohlen, sich an den Beispielen der Version 4.6 für die neue Szenenstruktur zu orientieren und die relevanten Komponenten neu zu erstellen.

Relevante Änderungen:

  • Prefabs wurden entfernt.
  • VIOCameraDeviceUnion wurde entfernt.
  • Die Unterstützung für AR Foundation wurde in ein eigenständiges Paket ausgelagert.

Wenn Sie AR Foundation nicht benötigen, können Sie den AR Foundation-Knoten unter der AR-Session in der Szene sowie die Verwendung von ARFoundationFrameSource im Code löschen.

Relevante Änderungen:

  • Die Unterstützung für AR Foundation wurde in ein eigenständiges Paket ausgelagert.

Wenn Sie Nreal nicht benötigen, können Sie den Nreal-Knoten unter der AR-Session in der Szene sowie die Verwendung von NrealFrameSource im Code löschen. Bei Verwendung von Nreal ist keine Erstellung eines virtuellen Pakets mehr erforderlich.

Relevante Änderungen:

  • Die Unterstützung für Nreal wurde in ein eigenständiges Paket ausgelagert.

Es wird empfohlen, sich an der Schnittstellendokumentation in den Skripten und den Beispielen der Version 4.6 zu orientieren, um Änderungen und Verwendungsweisen der Schnittstellen zu verstehen, und entsprechende Anpassungen vorzunehmen.

Relevante Änderungen:

  • Einige andere Skriptschnittstellen haben sich ebenfalls geändert.
  • Einige öffentliche Methoden sind in ihren XML-Kommentaren als "internal" markiert. Die Verwendung dieser Schnittstellen sollte vermieden werden; sie wurden in Version 4000 entfernt.

Migration zu version 4.4

Warnung

Version 4.4 wird nicht mehr gewartet. Es wird dringend empfohlen, direkt auf Version 4000 zu aktualisieren oder neuer. Die umfassende Unity-Entwicklerdokumentation auf der EasyAR-Website ist für Version 4000 und höher vorgesehen.

Die Migration zu Version 4.4 erfordert die Beachtung der folgenden Änderungen.

Verweise auf Prefabs innerhalb des Plugin-Pakets sollten nach Möglichkeit entfernt werden. Wenn diese Prefabs weiter verwendet werden, werden Warnprotokolle angezeigt, die kurze Hinweise auf Ersatzmöglichkeiten im neuen Plugin enthalten. Es wird empfohlen, sich an den Beispielen der Version 4.4 für die neue Szenenstruktur zu orientieren.

Relevante Änderungen:

  • Prefabs wurden als veraltet markiert und in Version 4.6 entfernt.

Die Verwendung von VIOCameraDeviceUnion entfernen. Wenn diese Komponente weiter verwendet wird, werden Warnprotokolle angezeigt, die kurze Hinweise auf Ersatzmöglichkeiten im neuen Plugin enthalten. Es wird empfohlen, sich an den Beispielen der Version 4.4 für die neue Szenenstruktur zu orientieren.

Relevante Änderungen:

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

Es wird empfohlen, sich an der Schnittstellendokumentation in den Skripten und den Beispielen der Version 4.4 zu orientieren, um Änderungen und Verwendungsweisen der Schnittstellen zu verstehen, und entsprechende Anpassungen vorzunehmen.

Relevante Änderungen:

  • Einige andere Skriptschnittstellen haben sich ebenfalls geändert.
  • Einige öffentliche Methoden sind in ihren XML-Kommentaren als "internal" markiert. Die Verwendung dieser Schnittstellen sollte vermieden werden; sie wurden in Version 4000 entfernt.