Table of Contents

Schnellstart mit beispielen für die easyar mega unity-entwicklung

Dieses tutorial zeigt, wie sie die easyar mega unity-beispiele konfigurieren und ausführen, um schnell mit der entwicklung für easyar mega zu beginnen.

Bevor Sie beginnen

Stellen Sie vor dem Lesen dieses Artikels sicher, dass Sie Folgendes erledigt haben:

  • Sie haben eine gültige Cloud-Lokalisierungsbibliothek.
  • Unity (2021.3.30 LTS oder höher) ist installiert. Es wird empfohlen, die neueste Version von Unity 2022.3 oder Unity 6.3 zu verwenden.
  • Die Pakete com.easyar.sense-**.tgz und com.easyar.mega-**.tgz gemäß der Methode in Mega aktivieren importiert.

Beispielhafte verwendung (in sechs schritten)

Im folgenden wird in sechs schritten erläutert, wie das kernbeispiel MegaBlock_Basic von EasyAR Mega konfiguriert und ausgeführt wird.

Schritt 1: Beispiel importieren

Anmerkung

Wenn alle Beispiele über **All Samples** importiert wurden, kann dieser Schritt übersprungen werden.

  1. Öffnen Sie den Package Manager über das Menü Window > Package Manager, wählen Sie EasyAR Sense Unity Plugin aus und erweitern Sie im rechten Bereich Samples alle Beispiele.
  2. Wählen Sie ein Beispiel aus (z.B. MegaBlock_Basic) und klicken Sie auf Import.

Import Sample

Anmerkung
  • Dieses Tutorial ist nicht direkt für Head-Mounted Displays (HMD) geeignet. Vor der Entwicklung für HMDs muss jedoch der Ablauf mit der Mobilentwicklung verstanden werden.
  • Wenn Sie zuvor Beispiele einer älteren SDK-Version importiert haben, müssen Sie diese nach einem SDK-Upgrade zunächst löschen und neu importieren.

Schritt 2: Füllen Sie den Lizenzschlüssel aus und konfigurieren sie den Mega Cloud-Speicherdienst

  1. Wählen Sie in der Menüleiste EasyAR > Sense > Configuration;
    License Guide
  2. Fügen Sie Ihren Lizenzschlüssel im geöffneten Project Settings-Panel ein;
    Fill License
Tipp

EasyAR Sense-Lizenzen können im EasyAR-Entwicklungszentrum erstellt werden. Für Erstnutzer:

  • Erstellen Sie EasyAR Sense 4.x Personal Edition
  • Wählen Sie bei "Sparse Spatial Map" Nein
  • Tragen Sie unter App-Name einen beliebigen Namen ein, bei Bundle ID und Package Name: com.mycompany.myproject
  • Wählen Sie die erstellte Lizenz und kopieren Sie den Schlüssel über die rechte Schaltfläche

copykey

Anmerkung

Bundle ID und Package Name können später geändert werden, allerdings begrenzt oft. Bei bekanntem App-Paketnamen können Sie diesen verwenden.

Personal Edition-Lizenzen sind unbegrenzt erstellbar, andere Typen bei Bedarf.

  1. Tragen Sie die Mega Cloud-Speicherdaten im Project Settings-Panel unter Mega Block ein;
    Mega Config Guide
Tipp

Mega-Konfigurationen erhalten Sie im EasyAR-Entwicklungszentrum.
Mega Config Detail
Stellen Sie sicher, dass Ihr API Key Mega Block-Berechtigungen hat.
API Key Auth

Schritt 3: Platzieren von 3D-inhalten

  1. Klicken Sie mit der rechten Maustaste auf einen leeren Bereich im Hierachy-Fenster und fügen Sie das Block-Betrachtungstool hinzu (Unity-Entwicklung);
    Add Block Viewer

  2. Auf mega positioning service zugreifen;

    1. Wählen Sie den Knoten EasyAR.Mega.BlockViewer (Dev) aus und geben Sie im Inspector-Bereich Ihre EasyAR-Kontoinformationen ein, um sich anzumelden;
      login
    2. Klicken Sie auf die Schaltfläche rechts neben Mega Cloud Service;
      Click Mega CLS
    3. Wählen Sie den gewünschten Mega-Positionierungsdienst aus und klicken Sie auf Bestätigen.
      Select Mega CLS

  3. Block laden

    Nach Auswahl des Dienstes wird die Liste der Blöcke in der aktuellen Bibliothek unter dem Knoten MegaBlocks angezeigt und im Tool-Bereich aufgeführt. Klicken Sie auf Laden, um den ausgewählten Block zu laden:
    Load Block

    Nach dem Laden wird der Block im Szene-Fenster angezeigt. Sie können im Szene-Fenster navigieren, um die Betrachtungsperspektive und Position anzupassen. Überprüfen Sie gleichzeitig, ob die Blockdatei verwendbar ist (z.B. ob das Block-Koordinatensystem korrekt ist, ob Schichtung vorhanden ist, ob es zu unscharf oder beschädigt ist, um AR-Ressourcen zu platzieren usw.).
    Display Block

  4. 3D-inhalte platzieren

    An dieser Stelle können Sie 3D-Objekte unter Bezugnahme auf den Block platzieren.
    Place 3D Object

    Anmerkung
    • 3D-Objekte müssen unter dem automatisch generierten Knoten MegaBlocks > Block_* platziert werden, um sicherzustellen, dass die Renderposition der virtuellen Inhalte zur Laufzeit korrekt ist.
    • Bitte ändern Sie weder den Namen des Block_*-Knotens noch dessen lokale Transformation, da diese automatisch vom Tool verwaltet werden.

Schritt 4: Konfigurieren von MegaTracker

  1. Konfigurieren Sie Block Root；

    Erweitern Sie AR Session, wählen Sie Mega Block Tracker und setzen Sie Block Root auf den generierten MegaBlocks-Knoten.
    Set Block Root

Schritt 5: Player-Konfiguration ändern

Navigieren Sie in Unity über File > Build Settings > Player Settings, klicken Sie auf das Android-Symbol, um die entsprechenden Einstellungen für die Android-Plattform aufzurufen.

switchtoandroid

  • Ändern Sie den Package Name in den auf der License-Key-Seite angezeigten Package-Namen

    androidPackageName

    Tipp

    Wenn Sie beispielsweise bei der Erstellung des License Keys com.mycompany.myproject als Package Name angegeben haben, muss hier com.mycompany.myproject eingetragen werden, andernfalls schlägt die Ausführung fehl.

  • Ändern Sie Minimum API Level auf API Level 21 oder höher

    androidAPILevel

  • Ändern Sie Scripting Backend zu IL2CPP und aktivieren Sie ARM64 unter Target Architecture

    androidarm64

Schritt 6: Erstellen und ausführen

  1. Füge die aktuelle Szene zu File > Build Settings oder Build Profiles > Scene List hinzu;
  2. Wechsle zur Zielplattform (z.B. Android/iOS), überprüfe ob Paketname (Bundle ID) und Lizenzschlüssel übereinstimmen;
    Plattform wechseln
  3. Klicke auf Build And Run.
    Build And Run

Live-Aufnahme des Betriebs:

Über gelben Text auf dem Bildschirm

Während der Laufzeit können zwei gelbe Texte auf dem Bildschirm angezeigt werden.

  1. Warnmeldung für Simulationsmodus

    Sie befindet sich am unteren Bildschirmrand:

    Diese Warnung erscheint, weil die Anwendung in der Standardkonfiguration nicht vor-Ort betrieben werden muss. Sie hat einen geringfügigen Einfluss auf die Leistung. Falls Sie sich vor-Ort befinden, können Sie die MegaTracker-Konfiguration vor dem Build anpassen.

  2. Diagnoseinformationen

    Sie erscheinen am oberen Bildschirmrand und dienen zur Überwachung des Sitzungsstatus und zur Problemdiagnose. Es wird empfohlen, sie während der Entwicklungs- und Testphase sichtbar zu lassen:

    Unter Diagnoseinformationen in der Szene finden Sie eine kurze Anleitung zur Konfiguration und Nutzung dieser Diagnoseinformationen.

Nächste Schritte: Von den Grundlagen zur Perfektion

Herzlichen Glückwunsch! Mit den oben genannten Schritten haben Sie die Kernbeispiele von EasyAR Mega erfolgreich in 10 Minuten ausgeführt und die Faszination der räumlichen Lokalisierung und AR-Inhaltsüberlagerung selbst erlebt.

Sie beherrschen nun die Grundlagen. Wenn Sie möchten:

  • Stabilere und effizientere AR-Anwendungen bauen
  • Komplexe Effekte wie virtuell-reale Okklusion oder Inhaltsausrichtung implementieren
  • Debuggen, wenn kein Gerät verfügbar ist oder Sie nicht vor Ort sein können

Dann ziehen Sie bitte die folgenden vertiefenden Leitfäden zurate. Sie helfen Ihnen, praktische Probleme während der Entwicklung zu lösen.

Fortgeschrittene entwicklung

Wenn Sie sich mit der vollständigen Projektkonfiguration vertraut machen möchten, können Sie folgende Inhalte konsultieren:

Falls Sie die Nutzung von EasyAR weiter vertiefen möchten, können Sie hier beginnen:

Gleichzeitig wird die Lektüre folgender Inhalte zur Entwicklung und Fehlersuche empfohlen:

Feinsteuerung der Mega-Funktionen

Die folgenden Inhalte helfen Ihnen, Mega besser in Ihrer Anwendung zu nutzen:

Die folgenden Inhalte helfen Ihnen, Mega-Funktionen zu überprüfen, ohne vor Ort zu sein:

Fortgeschrittene Themen

Die folgenden Inhalte sind besser geeignet, nachdem Sie bereits etwas Erfahrung mit EasyAR gesammelt haben.

Wenn Sie EasyAR Mega auf einem Headset ausführen möchten, können Sie die folgenden Inhalte konsultieren:

Wenn Sie AR Foundation verwenden möchten, können Sie hier beginnen: