Table of Contents

EasyAR-Projektkonfiguration und verwendung von AR Foundation-szenen

Bei der Verwendung von AR Foundation in Unity ist es oft notwendig, sich auf EasyAR zu verlassen, um die Gerätebeschränkungen von AR Foundation zu überwinden. Der folgende Inhalt erklärt, wie AR Foundation in EasyAR-Szenen korrekt konfiguriert und verwendet wird und wie es basierend auf der Geräteunterstützung dynamisch aktiviert wird.

Vor dem beginnen

Hinzufügen von AR Foundation-komponenten

Fügen Sie in der EasyAR-Szene die AR Session und XR Origin von AR Foundation hinzu.

Hinzufügen einer AR Session

Klicken Sie mit der rechten Maustaste auf eine leere Stelle in der Hierarchy-Ansicht und fügen Sie über das Menü XR > AR Session die Unity-ARSession zur Szene hinzu.

alt text

Anmerkung

Diese AR Session unterscheidet sich von der EasyAR AR Session; beide müssen gleichzeitig in der Szene vorhanden sein.

Hinzufügen eines XR Origin

Klicken Sie mit der rechten Maustaste auf eine leere Stelle in der Hierarchy-Ansicht und fügen Sie über das Menü XR > XR Origin (Mobile AR) die Unity-XROrigin zur Szene hinzu.

alt text

Anmerkung

Diese XR Origin überschneidet sich funktional mit der EasyAR XR Origin. Es muss die Unity XR Origin verwendet werden, nicht die von EasyAR.

Wenn in der Szene zuvor eine EasyAR XR Origin vorhanden war (typischerweise benannt als XR Origin (EasyAR)), müssen deren untergeordnete Objekte unter die neu erstellte XR Origin verschoben werden. Anschließend kann XR Origin (EasyAR) gelöscht werden.

alt text

Falls unter der neu erstellten XR Origin kein XR Origin Child vorhanden ist, muss dieses manuell hinzugefügt werden.

Wählen Sie in der Hierarchy-Ansicht XR Origin aus, klicken Sie mit der rechten Maustaste und fügen Sie über das Menü EasyAR Sense > Origin > Origin : XR Origin Child das XR Origin Child unter XR Origin hinzu.

alt text

Konfigurieren der kamera

Wenn in der Szene zuvor eine AR-Camera vorhanden war, werden Sie feststellen, dass jetzt redundante Hauptkameras vorhanden sind. Die ursprüngliche Kamera muss entfernt werden.

alt text

Wählen Sie dann die Main Camera unter XR Origin aus und konfigurieren Sie sie gemäß den Anweisungen in Kamerakonfiguration.

Abschließend sollte eine vollständige EasyAR-Szene mit hinzugefügter AR Foundation in etwa so aussehen:

alt text

Vorsicht

Wenn die Konfiguration von AR Foundation über ARCameraManager.currentConfiguration geändert werden soll, ist zu beachten, dass einige Smartphones (z.B. Xiaomi 10) Probleme aufweisen. Nach einer Konfigurationsänderung können möglicherweise keine Bilder mehr abgerufen werden, wodurch EasyAR unbrauchbar wird (die App zeigt einen Bildhintergrund, aber EasyAR-Funktionen reagieren nicht). Daher wird davon generell abgeraten. Falls erforderlich, benötigen Sie einen Fallback-Plan für den Fall, dass EasyAR nicht funktioniert.

Gerätekompatibilität und dynamische aktivierung von AR Foundation

EasyAR unterstützt wesentlich mehr Geräte als AR Foundation. Daher muss die Anwendung so konfiguriert werden, dass AR Foundation nur bei Bedarf aktiviert und in allen anderen Fällen vollständig deaktiviert wird.

Überprüfen der frame source-komponenten

In der Regel fügen über das EasyAR-Menü erstellte Sessions automatisch ARCoreARFoundationFrameSource und ARKitARFoundationFrameSource hinzu (außer bei einigen Bildverfolgungsfunktionen ohne SLAM-Anforderungen).

alt text

Wichtig

ARCoreARFoundationFrameSource und ARKitARFoundationFrameSource sind von EasyAR bereitgestellte Frame-Sources, um AR Foundation-Funktionen auf unterstützten Geräten zu aktivieren. Wenn die Session in der Szene diese Frame-Sources nicht enthält, kann die AR Foundation-Funktionalität nicht genutzt werden.

Falls die Session in der Szene diese Frame-Sources nicht enthält, können sie manuell über das Menü hinzugefügt werden.

alt text

Um die Ausführung auf nicht AR Foundation-fähigen Geräten zu gewährleisten, muss sichergestellt werden, dass die Session Frame-Sources enthält, die nicht auf AR Foundation basieren. Eine typische ARSession sollte in etwa so aussehen:

alt text

Tipp

Die Reihenfolge der Frame-Sources kann nach Bedarf angepasst werden. Zur Laufzeit wählt die Session basierend auf der Geräteunterstützung die erste verfügbare Frame-Source gemäß der Transformationsreihenfolge aus.

Aktivierung von AR Foundation nur bei bedarf

Da AR Foundation auf Smartphones auf ARCore und ARKit basiert und nur auf einer begrenzten Anzahl von Geräten funktioniert (insbesondere auf vielen chinesischen Android-Geräten nicht), wird generell empfohlen, AR Foundation und verwandte Funktionsskripte nur auf unterstützten Geräten zu aktivieren.

EasyAR kann dies automatisch übernehmen. Diese Funktion kann unter Project Settings > EasyAR > Sense > Unity XR > Unity XR Auto Switch aktiviert oder deaktiviert werden. Weitere Details finden Sie unter Automatisches Umschalten von Unity XR-Objekten.

Szenen mit AR Foundation-kompatibilität

Szenen, in denen die AR Foundation-Komponenten korrekt hinzugefügt wurden, funktionieren sowohl mit als auch ohne installiertem AR Foundation-Paket.

Ohne installiertem AR Foundation-Paket sind die AR Foundation-Funktionen und die entsprechenden Frame-Sources nicht verfügbar. Zudem fehlen in der Szene einige Skripte, was normal ist.

alt text alt text

Tipp

Viele Beispiele funktionieren sowohl mit als auch ohne installiertem AR Foundation-Paket. Um in diesen Beispielen AR Foundation-Unterstützung zu aktivieren, müssen Sie lediglich AR Foundation in EasyAR-Projekten aktivieren.

Nächste schritte

Verwandte themen