Table of Contents

Schnellstart für die EasyAR-Mega-Unity-Entwicklung mit Beispielen

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

Vor dem Start

Bevor Sie diesen Artikel lesen, stellen Sie sicher, dass Sie Folgendes erledigt haben:

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

Dieses Tutorial gilt nur für Unity-Plugins mit Version >= 4003. Wenn Sie versehentlich eine ältere Version heruntergeladen haben, aber noch die Einstiegsdokumentation lesen, laden Sie zuerst die neueste Plugin-Version herunter.

Beispielnutzung in sechs Schritten

Im Folgenden wird erklärt, wie Sie das Kernbeispiel von EasyAR Mega, MegaBlock_Basic, in sechs Schritten konfigurieren und ausführen.

Schritt 1: Beispiel importieren

Anmerkung

Wenn Sie alle Beispiele über **All Samples** importiert haben, können Sie diesen Schritt überspringen.

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

Beispiel importieren

Anmerkung
  • Dieses Tutorial ist nicht direkt für Headset-Geräte gedacht. Vor der Entwicklung für Headsets sollten Sie den Ablauf zunächst über die mobile Entwicklung verstehen.
  • Wenn Sie zuvor Beispiele älterer SDK-Versionen importiert haben, löschen Sie die alten Beispiele vor dem erneuten Import nach dem Upgrade des SDK.

Schritt 2: SDK und Mega-Cloud-Lokalisierungsdienst konfigurieren

  1. Wählen Sie in der Menüleiste EasyAR > Sense > Configuration;
    Lizenzanleitung

  2. Fügen Sie im geöffneten Fenster Project Settings Ihren License Key ein;
    Lizenz einfügen

    Tipp

    Die EasyAR-Sense-Lizenz können Sie im EasyAR Developer Center erstellen. Für den ersten Gebrauch können Sie wie folgt vorgehen:

    • EasyAR Sense 4.x Personal Edition erstellen
    • Bei Sparse Spatial Map Nein wählen
    • Anwendungsname beliebig eintragen, Bundle ID und Package Name auf com.mycompany.myproject setzen
    • Die gerade erstellte Lizenz auswählen und nach dem Öffnen auf die Schaltfläche rechts zum Kopieren klicken

    Kopierschlüssel

    Anmerkung

    Bundle ID und Package Name können später geändert werden, allerdings nur begrenzt oft. Wenn Sie bereits einen festen Paketnamen haben, können Sie auch gleich Ihren eigenen Paketnamen eintragen.

    Für die Personal Edition gibt es keine Begrenzung bei der Anzahl der erstellten Lizenzen. Andere Typen können bei Bedarf für den produktiven Einsatz erstellt werden.

  3. Prüfen und aktivieren Sie in Project Settings die Option Mega > Mega Block/Landmark support;

  4. Tragen Sie die Informationen Ihrer Mega-Cloud-Lokalisierungsbibliothek in den Eintrag Mega Block in Project Settings ein;
    Mega-Konfigurationsanleitung

    Tipp

    Die Konfiguration der Mega-Cloud-Lokalisierungsbibliothek erhalten Sie im EasyAR Developer Center.
    Mega-Konfig-Details
    Stellen Sie sicher, dass Ihr API Key die Berechtigungen für Mega Block und SpatialMap besitzt. Falls nicht, müssen Sie die Berechtigungen anpassen oder den Schlüssel neu erstellen.
    API-Key-Berechtigung
    Wenn Sie die Lokalisierungsbibliothek nicht finden, müssen Sie zuerst die Lokalisierungsbibliothek korrekt konfigurieren und dann erneut prüfen, ob die Cloud-Lokalisierungsbibliothek gültig ist.

Schritt 3: Mega Block konfigurieren

  1. Konfigurieren Sie Mega Block;

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

    Tipp

    Die Block-ID und der Name können im entsprechenden Positionsspeicher im EasyAR Developer Center abgerufen werden.

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

Schritt 4: 3D-Inhalte platzieren

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

  2. Prüfen Sie die Dienstinformationen und verbinden Sie sich mit dem Dienst;

    Tipp

    Wenn sonst keine Änderungen vorgenommen wurden, sollten die Dienstinformationen mit denen in Project Settings übereinstimmen.

    Nach erfolgreicher Verbindung mit dem Dienst sollten Sie die Aktualisierungszeit und die Steueroberfläche der Block-Editor-Daten sehen.

  3. Laden Sie die Block-Editor-Daten;

    Klicken Sie auf das erste Auswahlfeld unter den Block-Daten. Dadurch beginnt das Laden der Block-Editor-Daten. Nach dem Laden sehen Sie das Mesh des aktuellen Blocks im Scene-Fenster:

    Tipp

    Das Block-Mesh wechselt je nach Kameraposition die LOD. Sie müssen mit dem Internet verbunden bleiben.

  4. Platzieren Sie 3D-Inhalte

    An dieser Stelle können Sie das Block-Mesh als Referenz verwenden, um 3D-Objekte zu platzieren.

    Anmerkung
    • 3D-Objekte müssen unter dem Block-Knoten platziert werden, damit die Renderposition des virtuellen Inhalts zur Laufzeit korrekt ist.
    • 3D-Objekte dürfen nicht unter dem Knoten EasyAR.Mega.EditorTool platziert werden. Dieser Knoten wird nur für das Editor-Tool verwendet und kann in manchen Fällen automatisch gelöscht oder neu erstellt werden.

Schritt 5: Player-Konfiguration ändern

Wählen Sie in Unity nacheinander File > Build Settings > Player Settings und klicken Sie auf das Android-Symbol, um die Einstellungen für die Android-Plattform zu öffnen.

Android umschalten

  • Ändern Sie den Package Name auf den Package Name, der auf der License-Key-Seite angezeigt wird

    Android Package Name

    Tipp

    Wenn Sie beim Erstellen des License Keys zum Beispiel com.mycompany.myproject als Package Name eingetragen haben, müssen Sie hier denselben Package Name com.mycompany.myproject eintragen, sonst schlägt die Ausführung fehl.

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

    Android API Level

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

    Android ARM64

Schritt 6: Bauen und ausführen

  1. Fügen Sie die aktuelle Szene zu File > Build Settings oder Build Profiles > Scene List hinzu;
  2. Wechseln Sie auf die Zielplattform (z. B. Android / iOS) und prüfen Sie, ob die Paket-ID (Bundle ID) mit dem License Key übereinstimmt;
    Plattform wechseln
  3. Klicken Sie auf Build And Run.
    Build And Run

Der Laufzeiteffekt vor Ort sieht folgendermaßen aus:

Über den gelben Text auf dem Bildschirm

Während der Laufzeit können Sie zwei gelbe Textbereiche auf dem Bildschirm sehen.

  1. Warnung zur Simulation

    Sie befindet sich unten auf dem Bildschirm:

    Diese Warnung erscheint, weil die Anwendung in der Standardkonfiguration nicht zwingend vor Ort ausgeführt werden muss. Sie beeinflusst das Verhalten nur leicht. Wenn Sie sich tatsächlich vor Ort befinden, können Sie vor dem Build die MegaTracker-Konfiguration ändern.

  2. Diagnoseinformationen

    Sie befindet sich oben auf dem Bildschirm und dient dazu, den Session-Status und Probleme zu erkennen. Es wird empfohlen, sie während Entwicklung und Test sichtbar zu lassen:

    Weitere Informationen finden Sie unter Diagnoseinformationen in der Szene, um schnell zu verstehen, wie Sie diese Diagnoseinformationen konfigurieren und verwenden.

Nächster Schritt: vom Einstieg zur Beherrschung

Glückwunsch! Mit den obigen Schritten haben Sie das Kernbeispiel von EasyAR Mega erfolgreich innerhalb von 10 Minuten ausgeführt und die Faszination räumlicher Lokalisierung und AR-Inhaltsüberlagerung selbst erlebt.

Nun haben Sie die Grundlagen verstanden. Wenn Sie möchten:

  • stabilere und effizientere AR-Anwendungen erstellen
  • komplexe Effekte wie virtuelle Okklusion und Inhaltsausrichtung umsetzen
  • debuggen, wenn Geräte nicht verfügbar sind oder Sie nicht vor Ort sein können

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

Fortgeschrittene Entwicklung

Wenn Sie die vollständige Projektkonfiguration verstehen möchten, lesen Sie bitte:

Wenn Sie EasyAR weiter verstehen möchten, beginnen Sie hier:

Außerdem wird empfohlen, die folgenden Inhalte zu lesen, um Entwicklung und Debugging zu unterstützen:

Feingranulare Steuerung der Mega-Funktionen

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

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

Fortgeschrittene Themen

Die folgenden Inhalte eignen sich eher, wenn Sie bereits etwas Erfahrung mit EasyAR gesammelt haben.

Wenn Sie EasyAR Mega auf Headsets ausführen möchten, lesen Sie bitte:

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