Erstellung und hochladen von annotationen mit dem unity-editor

Dieser Artikel beschreibt, wie Sie mit dem Mega Studio im Unity-Editor Annotationen erstellen und hochladen.

Vorbereitung

Fähigkeit, Mega Studio in Unity zu verwenden
Modell vorbereiten: Verwenden Sie das im Beispielprojekt verwendete Modell (ein niedlicher Panda) oder das kleine Roboter-Modell aus der offiziellen xr-frame-Demo. Alternativ bereiten Sie gemäß den durch XRFrame ladbaren GLTF-Formaten und unterstützten Erweiterungen eine für xr-frame geeignete Modelldatei vor.
Importieren Sie die Modelldatei in Unity.

Tipp

Die Mega-Erweiterung enthält bereits eine Abhängigkeit von com.unity.cloud.gltfast, sodass Sie Modelldateien direkt in Unity-Assets ziehen können.

Warum annotationen benötigt werden

EasyAR Mega Annotation (EMA) ermöglicht die Synchronisierung räumlicher Positionen über Plattformen hinweg (mit unterschiedlichen Koordinatensystemdefinitionen).

Unity

Lokales Koordinatensystem einer Annotation in Unity: Positive X-Achse zeigt nach hinten, positive Y-Achse zeigt nach oben, positive Z-Achse zeigt nach rechts.

xr-frame

Lokales Koordinatensystem einer Annotation in xr-frame: Positive X-Achse zeigt nach hinten, positive Y-Achse zeigt nach oben, positive Z-Achse zeigt nach links.

Diese Richtungsunterschiede resultieren aus den unterschiedlichen Koordinatensystemdefinitionen (Links-/Rechtshändigkeit) von Unity und xr-frame.

Die Verwendung von EMA zur Synchronisierung räumlicher Positionen bietet folgende wesentliche Vorteile:

Vereinfachung des Entwicklungsprozesses: Automatische Handhabung plattformübergreifender Koordinatentransformationen, Vermeidung umständlicher Logik und Fehleranfälligkeit durch manuelle Berechnungen.
Steigerung der Debugging-Effizienz: Direktes Laden im MegaToolbox ermöglicht schnelles Testen auf dem Endgerät und Datenvalidierung.

Schritte zur durchführung

Erstellen des Annotationstools

Klicken Sie im Unity-Hierarchy-Panel mit der rechten Maustaste und wählen Sie: EasyAR Mega > Tool > Annotation Tool (Edit Mode).

Nach der Erstellung werden die Knoten EasyAR.Mega.Annotation und MegaBlocks in der Szene generiert.

Wählen Sie den Knoten EasyAR.Mega.Annotation aus. In seinem Inspector-Panel erscheinen Eingabefelder für Benutzername/E-Mail und Passwort.
Anmelden am Konto

Geben Sie EasyAR-Konto und Passwort ein und klicken Sie auf "Login". Bei Erfolg erscheint das Studio-Tool im Inspector-Panel.
Mega Cloud-Service-Bibliothek auswählen

Klicken Sie auf das Symbol rechts neben "Mega Cloud Service".

Wählen Sie die zu verwendende Bibliothek aus.

Nach erfolgreichem Laden der Bibliothek und der Mega Blocks-Informationen sieht das Studio-Tool-Panel wie folgt aus:
Dichtes Block-Modell laden

Klicken Sie auf "Laden" rechts neben dem Block-Namen, um das dichte Modell dieses Blocks dynamisch zu laden.

Das geladene Modell erscheint im "Scene"-Tab. Beachten Sie: Wenn links unten das dargestellte Symbol erscheint, ist das Modell im aktuellen Sichtfeld noch nicht vollständig geladen. Warten Sie, bis das Symbol verschwindet.
Annotation erstellen

Halten Sie in der Szene die Strg-Taste (Windows) / Befehl-Taste (Mac) gedrückt und klicken Sie mit der linken Maustaste an die gewünschte Stelle.
Modell verwenden

Ziehen Sie das importierte Modell in den Szenenknoten und machen Sie es zum untergeordneten Knoten der Annotation.

Setzen Sie im Inspector-Panel des Modells "Position" und "Rotation" auf 0. "Scale" kann bei Bedarf angepasst werden.

Anmerkung

EMA übernimmt die gesamte Koordinatentransformationslogik. Position und Rotation auf 0 zu setzen stellt sicher, dass der geometrische Mittelpunkt des Modells exakt mit dem Annotationspunkt übereinstimmt. Alle Positions- und Rotationsanpassungen sollten über den übergeordneten Knoten (Annotationsknoten) erfolgen.
[Optional] Präzise Positionierung des Modells

Für präzise Anpassungen von Position und Ausrichtung des Modells, siehe Anleitung zur präzisen Ausrichtung von 3D-Inhalten mit der realen Welt im Unity-Editor.
Neues Annotationspaket erstellen

Klicken Sie auf das Symbol rechts neben "Annotationspaket" im Inspector-Panel.

Geben Sie den Namen der Annotationsdaten ein und klicken Sie auf das Häkchen rechts.

Nach erfolgreicher Erstellung sollte es wie abgebildet aussehen. Klicken Sie anschließend auf "Bestätigen".

Klicken Sie auf das Upload-Symbol, um hochzuladen.

Nach erfolgreichem Upload erscheint eine Bestätigungsmeldung.
Annotations-ID notieren

Sie müssen den Namen oder die ID der Annotationsdaten notieren, um die entsprechenden Daten in xr-frame zu laden.

Nach dem Upload sind die Informationen auch im Cloud-Service sichtbar.

Hier können Name und ID der hochgeladenen Annotationsdaten eingesehen werden.