Mega-Tracking-Ziel hinzufügen

Dieses Dokument beschreibt, wie Sie Mega-Tracking-Ziele hinzufügen und konfigurieren.

Vor dem Start

Prüfen Sie unter Kann meine Lokalisierungsfunktion verwendet werden?, ob die Lokalisierungsbibliothek korrekt erstellt und die Karte hinzugefügt wurde.
Importieren Sie die neueste EasyAR-Version und aktivieren Sie die Mega-Funktion
Verstehen Sie die grundlegenden Konzepte und die Verwendung von Unity-AR-Tracking-Zielen

Anmerkung

Die folgenden Inhalte und Werkzeuge gelten nur für die Entwicklung von Unity-Anwendungen mit EasyAR Mega.

Wenn Sie ein Mini-Programm entwickeln, lesen Sie bitte Anmerkungen mit dem Unity-Editor erstellen und hochladen (Mini-Programm-Entwicklung).

Wenn Sie keine Unity-Anwendung entwickeln, aber die Ergebnisse des Mega-Mappings ansehen möchten, lesen Sie im Mega-Leitfaden 3D-Realwelt-Mesh anzeigen.

Wenn Sie keine Unity-Anwendung entwickeln, aber die Simulation zur Lokalisierungsanzeige ausführen möchten, lesen Sie im Mega-Leitfaden Simulationseffekt anzeigen.

Dieses Dokument erfordert, dass die folgenden Unity-Pakete bereits im Projekt importiert wurden:

Version >= 4003
Version 4.7 - 4002

com.easyar.sense

Ein Mega-Tracking-Ziel ist ein leeres Objekt mit der Komponente MegaBlockController. Es stellt in Unity einen Block dar.

alt text

Anmerkung

Wenn das Paket com.easyar.mega nicht importiert wurde, kann die Editor-Funktion des Blocks nicht verwendet werden. Laufzeit-Tracking und die übrigen Funktionen bleiben jedoch erhalten.

Wenn die Konfiguration die Mega-Funktion nicht korrekt aktiviert, kann sie nicht verwendet werden.

alt text

Tracking-Ziel erstellen

Version >= 4003
Version 4.7 - 4002

Klicken Sie im Hierarchy-Fenster an einer freien Stelle mit der rechten Maustaste. Über das Menü EasyAR Sense > Mega > Target : Mega Block können Sie ein Mega-Tracking-Ziel erstellen.

alt text

Im Skript können Sie ARSessionFactory.CreateController verwenden, um es zu erstellen.

ARSessionFactory.CreateController<MegaBlockController>();

Tracking-Ziel im Editor hinzufügen

Für diese Methode muss BlockHolder.BlockRootSource auf External (Standard) oder Mixed gesetzt sein.

Zuerst muss das Block Viewer for Unity Developer-Tool hinzugefügt werden.

Klicken Sie im Hierarchy-Fenster an einer freien Stelle mit der rechten Maustaste. Über das Menü EasyAR Mega > Tool > Block Viewer for Unity Developer (Edit Mode) können Sie das Unity-Developer-Tool für Block Viewer hinzufügen.

Wichtig

Wenn Sie Mega-Anwendungen mit Unity entwickeln, müssen Sie das Tool Block Viewer for Unity Developer verwenden. Die anderen Tools im Menü EasyAR Mega > Tool eignen sich nicht für die Entwicklung von Unity-Anwendungen.

Obwohl Annotation Tool ähnliche Funktionen bietet, werden einige Funktionen dieses Tools in zukünftigen Versionen entfernt. Daher wird seine Verwendung nicht empfohlen.

Die Markierungsfunktion von Annotation Tool (nur die Markierung selbst) wird in Kürze auf die EasyAR-Entwicklungszentrale im Web migriert. Das Laden des Block-Meshs und die Modellplatzierung bleiben davon unberührt.

Nach erfolgreichem Hinzufügen des Werkzeugs erscheinen im Szenenbaum ein Knoten EasyAR.Mega.BlockViewer (Dev) und ein Knoten MegaBlocks.

Verwenden Sie anschließend das Werkzeug, um Tracking-Ziele zu erzeugen.

Wählen Sie den Knoten EasyAR.Mega.BlockViewer (Dev) aus und geben Sie im Inspector Ihre EasyAR-Kontoinformationen ein und melden Sie sich an.

Klicken Sie auf die Schaltfläche rechts neben Mega Cloud Service.

Wählen Sie den zu verwendenden Mega-Lokalisierungsdienst und klicken Sie auf OK.

Nach der Auswahl des Dienstes wird die aktuelle Block-Liste unter dem Knoten MegaBlocks und im Werkzeugfenster angezeigt.

Tipp

Warum ist MegaBlocks bei mir leer?

Prüfen Sie bitte unter Kann meine Lokalisierungsfunktion verwendet werden?, ob die Lokalisierungsbibliothek korrekt erstellt und die Karte hinzugefügt wurde.

Damit sind die Tracking-Ziele erstellt. Jeder Unterknoten unter MegaBlocks, der mit Block_ beginnt, stellt ein Block-Tracking-Ziel dar.
Tracking-Ziel automatisch hinzufügen, wenn die Lokalisierung erfolgreich ist

Für diese Methode muss BlockHolder.BlockRootSource auf Internal oder Mixed gesetzt sein.

In diesen beiden Modi wird ein neuer Block automatisch unter BlockHolder.BlockRoot hinzugefügt, wenn ein neuer Block lokalisiert wird und der entsprechende Block nicht unter BlockHolder.BlockRoot vorhanden ist. Wenn BlockHolder.BlockRoot nicht existiert, wird er automatisch erstellt.

Tipp

Beim automatischen Hinzufügen von Tracking-Zielen bei erfolgreicher Lokalisierung kann kein Block-Modell geladen werden. Es werden nur Block-Tracking-Ziele hinzugefügt.
Tracking-Ziel im Skript hinzufügen

Für diese Methode muss BlockHolder.BlockRootSource auf Internal oder Mixed gesetzt sein. In diesem Fall wird BlockHolder.BlockRoot automatisch erstellt, falls er nicht existiert. Alternativ können Sie BlockHolder.BlockRootSource auf External setzen und im Editor vorher ein BlockHolder.BlockRoot-Objekt angeben.

Anmerkung

Wenn der Block nicht in der Lokalisierungsbibliothek vorhanden ist, kann er auch dann nicht lokalisiert werden, wenn Sie ihn per Skript zur Szene hinzufügen.

Sie können die Methode BlockHolder.Hold verwenden, um einen neuen Block unter dem Knoten BlockHolder.BlockRoot hinzuzufügen. Diese Methode wird typischerweise verwendet, wenn eine ema-Annotationsdatei gelesen und daraus Blockdaten hinzugefügt werden.

Das folgende Codebeispiel zeigt, wie Sie mithilfe der Informationen aus einer Annotationsdatei einen Block hinzufügen:
```
foreach (var item in ema.blocks)
{
    var info = new BlockController.BlockInfo { ID = item.id.ToString(), Timestamp = item.timestamp };
    if (!item.keepTransform && item.location.OnSome)
    {
        blockHolder.Hold(info, item.location.Value);
    }
    else
    {
        blockHolder.Hold(info, item.transform.ToUnity());
    }
}
```
Tipp

Wenn Sie Tracking-Ziele zur Laufzeit per Skript hinzufügen, kann kein Block-Modell geladen werden. Es werden nur Block-Tracking-Ziele hinzugefügt.

Tracking-Ziel konfigurieren

Datenquelle des Targets konfigurieren

Version >= 4003
Version 4.7 - 4002

Ein Tracking-Ziel kann nur erkannt und verfolgt werden, wenn seine Quelle korrekt konfiguriert ist.

Im Hierarchy-Fenster können Sie den Block-Knoten auswählen und anschließend die ID und den Namen des Blocks eintragen.

Im Skript können Sie vor MonoBehaviour.Start() die Source ändern, um die Quelle des Blocks festzulegen.

block.Source = new MegaBlockController.BlockInfoSourceData(id, name);

Dabei gilt:

Die Block-ID ist die eindeutige Kennung des Blocks und muss angegeben werden.
Der Block-Name ist der Name des Blocks und kann frei gewählt werden. Empfehlenswert ist der echte Name des Blocks, damit er leichter zu erkennen ist.

Tipp

Block-ID und Name können im EasyAR Developer Center aus der entsprechenden Lokalisierungsbibliothek bezogen werden.

Wenn in der Lokalisierungsbibliothek keine Blockdaten vorhanden sind, müssen Sie den benötigten Block zur Lokalisierungsbibliothek hinzufügen und anschließend erneut prüfen, ob die Cloud-Lokalisierungsbibliothek gültig ist.

In MegaTrackerFrameFilter wird das verwendete Target, also der Block, festgelegt.

In den meisten Fällen empfiehlt es sich, die Standardkonfiguration beizubehalten, also den Block im Editor mit Mega Studio zu importieren.

Wählen Sie das Objekt Mega Tracker unter der Session aus. Die Option Block Root Source sollte auf External (Standard) bleiben.

Außerdem muss Block Root auf das Objekt MegaBlocks in der Szene gesetzt werden.

Mit der Option Block Root Source können Sie andere Quellen für Blöcke festlegen, zum Beispiel wählt man bei der Verwendung von ema-Importdaten normalerweise Internal oder Mixed.

Im Skript können Sie die gleiche Wirkung erzielen, indem Sie BlockHolder.BlockRootSource ändern.

Tracker für das Target konfigurieren

Version >= 4003
Version 4.7 - 4002

Das Tracking-Ziel wird vom konfigurierten Tracker geladen und nach erfolgreicher Lokalisierung verfolgt.

Im Hierarchy-Fenster können Sie den Block-Knoten auswählen und anschließend im Session-Bereich Mega Tracker wählen.

Im Skript können Sie Tracker ändern, um den Tracker des Blocks festzulegen.

block.Tracker = megaTracker;

Tracker kann zur Laufzeit jederzeit geändert werden. Laden und Entladen erfolgen während der Laufzeit der Session. Wenn Sie Tracker auf null setzen, wird das Target vom zuvor gesetzten Tracker entladen. Das Laden des Blocks ist ein virtueller Vorgang und kann nicht fehlschlagen.

Anmerkung

Damit ein Target verfolgt wird, müssen einige wichtige Bedingungen erfüllt sein:

Die ID von MegaBlockController.Source muss vor MonoBehaviour.Start() korrekt konfiguriert sein.
Der Block mit der ID aus Source muss in der Lokalisierungsbibliothek vorhanden sein.
MegaBlockController.Tracker muss für die richtige Lokalisierungsbibliothek konfiguriert sein.

Normalerweise ist keine zusätzliche Konfiguration nötig. Wenn jedoch eine Mehrziel-Steuerung benötigt wird, können die entsprechenden Einstellungen vorgenommen werden.

In den meisten Mega-Szenarien ist kein Multizielbetrieb nötig. Solange Sie noch nicht sicher sind, wie mehrere Blöcke sich gegenseitig beeinflussen, sollte in einer Lokalisierungsbibliothek nur ein Block enthalten sein.

Tipp

Prinzipiell berechnet Mega die Position des Geräts in allen Blöcken und wählt nicht einfach einen sichtbaren Block aus der Lokalisierungsbibliothek aus. Eine unbedachte Verwendung kann durch Datenverwechslung und ähnliche Probleme die Ergebnisse verschlechtern.

Wählen Sie das Objekt Mega Tracker unter der Session aus und ändern Sie die Option Multi Block, um die Multizielverfolgung ein- oder auszuschalten.

Im Skript können Sie dieselbe Wirkung erzielen, indem Sie BlockHolder.MultiBlock ändern.

Warnung

In der Regel kann eine Lokalisierungsbibliothek nur einen Block gleichzeitig enthalten.

Änderungen an der Multizielkonfiguration beeinflussen die Trackingqualität und werden normalerweise nicht empfohlen. Verwenden Sie sie bitte nur unter Anleitung des EasyAR-Supports.

Wenn diese Konfiguration während der Anwendung geändert wurde, teilen Sie dies bitte unbedingt mit, wenn Sie ein Problem an EasyAR melden.

Lebenszyklus des Tracking-Ziels

Version >= 4003
Version 4.7 - 4002

Ein typischer Lebenszyklus eines Tracking-Ziels sieht folgendermaßen aus:

flowchart LR
  sstart((Session-Start))
  sstop([Session-Stopp])
  
  start("Target.Start")
  load("Laden")
  tracking[["Dauerhaftes Tracking"]]

  sstart --> load --> tracking --> sstop
  start -. "Target.Tracker = tracker" .-> load

Der Ablauf lässt sich grob in folgende Phasen gliedern:

Laden: Das Tracking-Ziel wird vom konfigurierten Tracker geladen. Dies geschieht nach dem eigenen Start() des Targets und nach dem Start der Session.
Tracking: Nachdem das Tracking-Ziel lokalisiert wurde, verfolgt der Tracker dessen Position und Status fortlaufend, bis ein anderes Ziel lokalisiert wird.
Entladen: Das Tracking-Ziel wird aus dem Tracker entfernt und der Tracker verfolgt das Ziel nicht mehr. Dies geschieht beim Stopp der Session oder wenn dem Target kein Tracker mehr zugewiesen ist.

Table of Contents

Mega-Tracking-Ziel hinzufügen

Vor dem Start

Anmerkung

Mega-Tracking-Ziele

Anmerkung

Tracking-Ziel erstellen

Wichtig

Tipp

Tipp

Anmerkung

Tipp

Tracking-Ziel konfigurieren

Datenquelle des Targets konfigurieren

Tipp

Tracker für das Target konfigurieren

Anmerkung

Tipp

Warnung

Lebenszyklus des Tracking-Ziels

Nächste Schritte

Verwandte Themen