Table of Contents

Schnellstart mit EasyAR Unity-entwicklung anhand von beispielen

Dieses tutorial zeigt, wie Sie die EasyAR Unity-beispiele konfigurieren und ausführen, um schnell in die AR-entwicklung einzusteigen.

Vorbereitung eines leeren Unity-Projekts

Stellen Sie sicher, dass eine kompatible Unity-Version installiert ist (Unity 2021.3 oder höher). Empfohlen wird die neueste Version von Unity 2022.3 oder Unity 6.3.

Erstellen Sie ein leeres Unity-Projekt mit der Vorlage 3D (Built-in Render Pipeline):

Anmerkung

Für die erste Nutzung wird URP nicht empfohlen.

Falls Sie Unity 6 verwenden, laden Sie manuell die Vorlage 3D (Built-In Render Pipeline) Template herunter und verwenden Sie diese. Bei Standardinstallation befindet sie sich weiter unten in der Vorlagenliste.

Wichtig

Für die Verwendung von URP müssen zusätzliche Konfigurationen gemäß Universal Render Pipeline (URP) vorgenommen werden, da sonst die Kamerabilder nicht angezeigt werden.

Importieren des EasyAR Sense Unity Plugins

  • Herunterladen des Plugin-Pakets
    • Laden Sie die neueste Version von EasyAR Sense Unity Plugin herunter, die Beispiele (Samples) enthält.
    • Nach dem Entpacken der zip-Datei finden Sie eine readme-Datei und .tgz-Dateien. Die .tgz-Dateien können direkt in Unity importiert werden – nicht entpacken.
    • Speichern Sie die .tgz-Datei im Packages-Ordner Ihres Unity-Projekts.
  • Importieren des Plugin-Pakets
    • Navigieren Sie in der Menüleiste zu Window und wählen Sie Package Manager.
    • Klicken Sie im neuen Fenster links oben auf das +-Symbol und wählen Sie Install Package from tarball ....
    • Wählen Sie im Dialogfeld die zuvor genannte .tgz-Datei aus.

ImportUnityPlugin

Anmerkung

Die .tgz-Datei darf nach dem Import in Unity nicht gelöscht oder verschoben werden. Platzieren Sie sie vor dem Import an einem geeigneten Ort. Empfohlen wird der Packages-Ordner des Unity-Projekts zur einfacheren Versionsverwaltung.

Beispiel importieren

Öffnen Sie den Package Manager über Window > Package Manager, wählen Sie EasyAR Sense Unity Plugin aus und importieren Sie alle Beispiele auf einmal, indem Sie auf der rechten Seite **All Samples** auswählen.

ImportSample

Vorsicht

**All Samples** und andere Beispiele können nicht gleichzeitig importiert werden, da dies zu doppelten Assets führt und teilweise Szenenressourcen verloren gehen. Falls versehentlich doppelte Dateien importiert wurden, müssen diese gelöscht und erneut importiert werden.

Ändern der szenenliste

Öffnen Sie Build Settings (oder Build Profiles),

Fügen Sie die Beispielszenen aus dem Unity-Projekt zur Scene List in Build Settings oder Build Profiles hinzu und verschieben Sie die Starterszene für Beispiele (AllSamplesLauncher) an die erste Position aller Szenen.

Vorsicht

Fügen Sie diese Szenen für Head-Mounted-Displays nicht hinzu, da dies zu Build-Fehlern führen kann:

  • Combination_BasedOn_AppleVisionPro.rst
  • Combination_BasedOn_Xreal.rst

Lizenzschlüssel eingeben

Wählen Sie im Unity-Menü EasyAR > Sense > Configuration, um die EasyAR Sense-Einstellungen aufzurufen.

FillInKey

Geben Sie den EasyAR Sense-Lizenzschlüssel in das Eingabefeld unter EasyAR Sense License ein.

FillInKey2

Tipp

EasyAR Sense-Lizenzen können im EasyAR Developer Center (中文, English) erstellt werden. Bei der ersten Verwendung können Sie wie folgt vorgehen:

  • Erstellen Sie EasyAR Sense 4.x Personal-Edition
  • Wählen Sie bei "Sparse-space-map" Ja, der Name kann beliebig sein
  • Der Anwendungsname kann beliebig sein, geben Sie bei Bundle ID und Package Name com.mycompany.myproject ein
  • Wählen Sie die neu erstellte Lizenz aus und klicken Sie auf die Schaltfläche "Kopieren" rechts

copykey

Anmerkung

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

Die Erstellung der Personal-Edition ist unbegrenzt möglich, andere Editionen können bei Bedarf für den offiziellen Einsatz erstellt werden.

Im editor ausführen

Im editor ausführen benötigt, dass ihr computer mit einer kamera verbunden ist.

Bestätigen Sie, dass die Systemkamera funktioniert

Öffnen Sie die Systemkamera-App:

Stellen Sie sicher, dass die Kamera ordnungsgemäß funktioniert:

Schließen Sie abschließend die Kamera-App, um Konflikte beim Ausführen der Beispiele zu vermeiden.

[!HINWEIS] EasyAR verwendet nur die vom System bereitgestellten Schnittstellen zum Öffnen der Kamera. Stellen Sie sicher, dass die Systemkamera-App die Kamera öffnen und normal anzeigen kann.

Ausführungsbeispiel

Der folgende Inhalt verwendet das Beispiel zur Bildverfolgung ImageTracking_Targets als Referenz. Andere Beispiele werden auf ähnliche Weise ausgeführt.

Öffnen Sie die Beispiel-Starterszene und klicken Sie auf die Schaltfläche Play oben im Unity-Editor.

Wechseln Sie in die Szene ImageTracking_Targets.

Tipp

Sie können auch direkt die ImageTracking_Targets-Szene öffnen und ausführen.

Richten Sie die Kamera auf folgendes Zielbild:

namecard

Downloadlink: 🔗 namecard

EasyAR erkennt und verfolgt dieses Bild und überlagert virtuelle Objekte.

Anmerkung

Einige Funktionen können im Editor nicht mit Kamerazugriff ausgeführt werden, funktionieren jedoch auf Mobilgeräten. Beispiele, die im Editor nicht verfügbar sind, zeigen beim Start ein Fehler-Popup an.

Gleichzeitig erscheinen Hinweismeldungen und Fehler-Log-Ausgaben.

Auf handy ausführen

Das ausführen auf dem handy erfordert eine Verpackung, vor der Verpackung muss die Player-Konfiguration geändert werden.

Player-Konfiguration ändern

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

switchtoandroid

  • Ändere Package Name in den auf der License-Key-Seite angezeigten Package Name

    androidPackageName

    Tipp

    Beispiel: Wenn der bei der Erstellung des License Keys angegebene Package Name com.mycompany.myproject war, muss hier Package Name auf com.mycompany.myproject gesetzt werden, sonst schlägt die Ausführung fehl.

  • Ändere Minimum API Level auf API Level 21 oder höher

    androidAPILevel

  • Ändere Scripting Backend auf IL2CPP und aktiviere ARM64 unter Target Architecture

    androidarm64

Anwendung packen

Wählen Sie Datei > Buildeinstellungen, wählen Sie die Zielplattform (Android/iOS) und dann Plattform wechseln.

Plattform wechseln

Wählen Sie Erstellen oder Erstellen und ausführen, um das Projekt zu kompilieren und auf dem Telefon zu installieren. Zur Laufzeit müssen die entsprechenden Berechtigungen erteilt werden.

Erstellen und ausführen

Beispiel ausführen

Der folgende Inhalt verwendet das Beispiel zur Bildverfolgung ImageTracking_Targets. Andere Beispiele werden ähnlich ausgeführt.

Nach dem Start sollte die Beispiel-Launcher-Szene gestartet werden.

Tipp

Wenn nach dem Öffnen nicht die Beispiel-Launcher-Szene angezeigt wird, überprüfen Sie, ob die Szenenliste in Build Settings oder Build Profiles korrekt eingestellt ist. Stellen Sie sicher, dass AllSamplesLauncher an erster Stelle steht.

Wechseln Sie in die Szene ImageTracking_Targets.

Richten Sie die Handykamera auf folgendes Erkennungsbild aus:

namecard

Downloadadresse: 🔗 namecard

EasyAR erkennt und verfolgt dieses Bild und überlagert virtuelle Objekte.

Nächste Schritte

Sie haben das Unity AR-Beispiel erfolgreich ausgeführt und sind möglicherweise daran interessiert, wie die demonstrierte AR-Szene erstellt wurde. Sie können die folgenden Einführungsleitfäden in der angegebenen Reihenfolge lesen:

Detaillierte Anweisungen zum Beispiel-Launcher finden Sie hier:

Wenn Sie die vollständige Projektkonfiguration verstehen möchten, können Sie folgende Inhalte konsultieren:

Wenn Sie die Verwendung von EasyAR weiter vertiefen möchten, können Sie hier beginnen: