Table of Contents

Schneller Einstieg in die EasyAR Mega Unity-Entwicklung mit Beispielanwendungen

Dieses Tutorial erklärt, wie Sie die EasyAR Mega Unity-Beispiele konfigurieren und ausführen, um schnell mit der EasyAR Mega-Entwicklung zu beginnen.

Vorbereitung

Bevor Sie mit diesem Tutorial beginnen, stellen Sie bitte sicher, dass Sie Folgendes erledigt haben:

  • Sie verfügen über 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.
  • Importieren Sie die Pakete com.easyar.sense-**.tgz und com.easyar.mega-**.tgz gemäß der Anleitung unter Mega aktivieren.
Anmerkung

Dieses Tutorial gilt nur für die Unity-Plugin-Version >= 4003. Falls Sie zufällig eine ältere Version heruntergeladen haben, aber noch die Einführungsdokumentation lesen, müssen Sie zuerst die neueste Version des Plugins herunterladen.

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.

Zweiter Schritt: Konfigurieren des SDK und des Mega-Cloud-Lokalisierungsservices

  1. Wählen Sie im Menü EasyAR > Sense > Configuration;
    License Guide

  2. Fügen Sie in der geöffneten Project Settings-Leiste Ihren License Key ein;
    Fill License

    Tipp

    Der EasyAR Sense License kann über das EasyAR Development Center erstellt werden. Wenn Sie es das erste Mal verwenden, können Sie es wie folgt erstellen:

    • Erstellen Sie eine EasyAR Sense 4.x Personal Edition.
    • Wählen Sie für die dünne Raumkarte Nein.
    • Geben Sie einen beliebigen Namen für die App ein. Geben Sie für die Bundle ID und den Package-Name com.mycompany.myproject ein.
    • Wählen Sie die gerade erstellte Lizenz aus, gehen Sie hinein und klicken Sie auf die Kopierschaltfläche rechts.

    copykey

    Anmerkung

    Die Bundle ID und der Package-Name können später geändert werden, aber die Anzahl der Änderungen ist begrenzt. Wenn Sie einen bestimmten App-Paketnamen haben, können Sie auch Ihren eigenen Paketnamen eingeben.

    Es gibt keine Beschränkung bei der Anzahl der Erstellungen der Personal Edition. Andere Typen können bei Bedarf erstellt werden, wenn sie offiziell verwendet werden können.

  3. Überprüfen Sie und aktivieren Sie die Option Mega > Mega Block/Landmark support in der Project Settings-Leiste;

  4. Konfigurieren Sie die Informationen Ihrer Mega-Cloud-Lokalisierungsbibliothek im Mega Block-Eintrag der Project Settings-Leiste;
    Mega Config Guide

    Tipp

    Die Konfiguration der Mega-Cloud-Lokalisierungsbibliothek kann über das EasyAR Development Center abgerufen werden.
    Mega Config Detail
    Stellen Sie sicher, dass Ihr API Key die Berechtigungen für Mega Block und SpatialMap hat. Wenn nicht, müssen Sie diese ändern oder neu erstellen.
    API Key Auth
    Wenn die Lokalisierungsbibliothek nicht gefunden werden kann, müssen Sie zunächst die Lokalisierungsbibliothek korrekt konfigurieren und erneut überprüfen, ob die Cloud-Lokalisierungsbibliothek gültig ist.

Schritt 3: konfiguration von mega block

  1. Mega Block konfigurieren;

    Wählen Sie Mega Block aus und geben Sie die ID und den Namen des Blocks ein.

    Tipp

    Block-ID und -Name können Sie aus der entsprechenden lokalisierungsdatenbank im EasyAR-Entwicklerzentrum erhalten.

    Wenn es keine Block-daten in der lokalisierungsdatenbank gibt, müssen Sie den benötigten Block in der lokalisierungsdatenbank hinzufügen und erneut überprüfen, ob die cloud-lokalisierungsdatenbank gültig ist.

Schritt 4: 3D-Inhalte platzieren

  1. Wählen Sie Mega Block und erstellen Sie das Editor-Tool;

  2. Überprüfen Sie die Service-Informationen und verbinden Sie den Service;

    Tipp

    Wenn keine anderen Änderungen vorgenommen wurden, sollten die Service-Informationen mit den in Project Settings eingetragenen übereinstimmen.

    Nach erfolgreicher Verbindung mit dem Service sollten Sie die Aktualisierungszeit und die Steueroberfläche für die Block-Editor-Daten sehen.

  3. Block-Editor-Daten laden;

    Klicken Sie auf das erste Auswahlfeld unter "Block data". Dadurch wird der Ladevorgang für die Block-Editor-Daten gestartet. Nach dem Laden können Sie das aktuelle Block-Mesh im Scene-Fenster sehen:

    Tipp

    Das Block-Mesh wechselt je nach Kameraposition den LOD. Eine Netzwerkverbindung ist erforderlich.

  4. 3D-Inhalte platzieren

    Jetzt können Sie 3D-Objekte unter Bezugnahme auf das Block-Mesh platzieren.

    Anmerkung
    • 3D-Objekte müssen unter dem Block-Knoten platziert werden, um sicherzustellen, dass die virtuelle Inhalte zur Laufzeit an der richtigen Position gerendert werden.
    • 3D-Objekte dürfen nicht unter dem EasyAR.Mega.EditorTool-Knoten platziert werden. Dieser Knoten wird nur für das Editor-Tool verwendet und kann in einigen Fällen automatisch gelöscht oder neu erstellt werden.

Schritt 5: Player-Konfiguration anpassen

Navigieren Sie in Unity über Datei > Buildeinstellungen > Playereinstellungen, 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 Name

    androidPackageName

    Tipp

    Wenn Sie beispielsweise bei der Erstellung des License Keys com.mycompany.myproject als Package Name angegeben haben, müssen Sie hier ebenfalls com.mycompany.myproject eintragen, da die Ausführung sonst fehlschlägt.

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

    androidAPILevel

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

    androidarm64

Schritt sechs: 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) und überprüfe, ob der Paketname (Bundle ID) mit dem License Key übereinstimmt;
    Switch Platform
  3. Klicke auf Build And Run.
    Build And Run

Die Laufzeiteffekte vor Ort sind wie folgt:

Ü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: