Table of Contents

Schneller Zugriff auf EasyAR-Beispiele mit AllSamplesLauncher

Der AllSamplesLauncher ist ein integrierter Beispielstarter, der Ihnen hilft, sich schnell mit den Funktionen des EasyAR SDK vertraut zu machen. Mit diesem Launcher können Sie mit einem Klick zwischen allen offiziellen Beispielszenen in einem einzigen Unity-Projekt wechseln und sie ausführen, ohne mehrere unabhängige Projekte manuell konfigurieren zu müssen.

Vorbereitungen

Stellen Sie vor Beginn sicher, dass Sie folgende Vorbereitungen abgeschlossen haben:

  1. Unity Hub und den Unity-Editor installiert haben
  2. Ein neues Unity-Projekt erstellt haben
  3. Das EasyAR Sense Unity Plugin importiert und alle Samples importiert haben

Bitte folgen Sie den schrittweisen Anleitungen in der Schnellstartanleitung.

Detaillierte Schritte

  1. Öffnen Sie alle Szenen in den Samples.
    All Sample Scenes
  2. Klicken Sie in der Menüleiste auf File > Build Settings oder Build Profiles > Scene List.
  3. Ziehen Sie alle Szenen in die Scene List.
  4. Stellen Sie sicher, dass AllSamplesLaucher an erster Stelle in der Liste steht. Falls nicht, ziehen Sie ihn innerhalb des Fensters nach oben.
    Scene List Order
  5. Klicken Sie in der Menüleiste auf File > Build And Run, um das Projekt zu erstellen und auszuführen.
Anmerkung

Fügen Sie beim Erstellen für Mobilgeräte keine Szenen für Headset-Geräte hinzu:

  • Combination_BasedOn_AppleVisionPro
  • Combination_BasedOn_Xreal
    Donot Load Headset

Probleme beim Erstellen

Während des Kompilierens und Erstellens können Fehler auftreten. Häufige Probleme sind:

Fehlermeldung Ursache Lösung
FileNotFoundException:EasyAR Settings Asset Kein Lizenzschlüssel hinterlegt Klicken Sie auf EasyAR > Sense > Configuration und tragen Sie Ihren License Key unter EasyAR Sense License ein
Missing Prefab Asset: 'XR Interaction Setup' Fehlende Headset-bezogene Dateien Entfernen Sie Headset-Szenen aus der Szenenliste. Wenn Sie Headsets benötigen, folgen Sie den Schritten unter Verwendung von Headset-Beispielen

Verwendung des Launchers

Nach dem Start sehen Sie eine übersichtliche Launcher-Oberfläche.

Lanucher Homepage

Klicken Sie auf den Samples-Button in der unteren Mitte, um zu den Beispielen aller Funktionen zu gelangen.

Lanucher Samplepage

Links finden Sie Funktionskategorien, rechts die Liste der Beispielszenen pro Funktion. Durch Anklicken verschiedener Beispielszenen können Sie alle Funktionen von EasyAR erkunden.

Zusätzlich zeigen Demo-Videos für EasyAR Sense und EasyAR Mega am unteren Rand, welche Möglichkeiten EasyAR bietet.

Wichtige Hinweise vor dem Ausführen der Beispiele

Vor dem Ausführen bestimmter Beispiele müssen Sie folgende Schlüsseleinstellungen vornehmen, da die Beispiele sonst nicht funktionieren:

  1. Setzen Sie Ihren API Key

    • Einige Beispiele (insbesondere Cloud-Erkennung, Mega Cloud-Positionierung) benötigen einen gültigen API Key.
    • Gehen Sie zu EasyAR > Sense > Configuration und suchen Sie die entsprechenden Felder für das Beispiel.
    • Tragen Sie die App ID, den API Key und das API Secret ein, die Sie im EasyAR Developer Center erhalten haben.
      Key Configuration
    • Wichtig: Ohne API Key funktionieren lokale Funktionen (wie Bildverfolgung) möglicherweise, Cloud-Funktionen jedoch nicht. Holen Sie sich unbedingt einen Key im EasyAR Developer Center.
  2. Konfigurieren Sie XR/Plattformunterstützung:

    • Für Headset-bezogene Beispiele folgen Sie bitte den Anweisungen unter Verwendung von Headset-Beispielen.
    • Stellen Sie sicher, dass Ihr Gerät (z.B. Smartphone oder Headset) korrekt verbunden und im Entwicklermodus ist.

Vertiefte Erkundung der Beispiele

Der Beispiel-Launcher ist der beste Ausgangspunkt zum Lernen. Wir empfehlen dringend:

  • Erst ausführen, dann analysieren: Erleben Sie schnell die Wirkung jedes Beispiels und gewinnen Sie einen intuitiven Eindruck von EasyARs Fähigkeiten.
  • Öffnen Sie die Szenen-Quelldateien: Jedes Beispiel ist eine eigenständige Unity-Szene, gespeichert unter Assets/Samples/EasyAR Sense Unity Plugin/[Version]/__All Samples__/[Funktionsname]/[Beispielname]/Scenes.
  • Untersuchen Sie die Skripte: Öffnen Sie die mitgelieferten *.cs-Skripte in den Beispielszenen, um zu sehen, wie EasyAR-APIs für spezifische Funktionen aufgerufen werden. Dies ist der beste Weg, die API-Nutzung zu lernen.

Mit dem Beispiel-Launcher können Sie schnell ein Verständnis für die Funktionen des EasyAR SDK aufbauen. Viel Spaß beim Erkunden!