Table of Contents

Aktivierung von AR Foundation in EasyAR-Projekten

Um die AR Foundation-Unterstützung von EasyAR zu aktivieren oder andere Funktionen von AR Foundation zu nutzen, müssen AR Foundation ordnungsgemäß installiert und konfiguriert werden. Die folgenden Schritte erläutern diese Vorgänge.

Vorbereitung

Kompatibilität der AR Foundation-Versionen

EasyAR unterstützt AR Foundation Version 5 oder neuer.

Wichtig

Die Unterstützung für AR Foundation erfolgt durch eine benutzerdefinierte Kamera.

Verwendung von Testprodukten (Personal-Lizenz, Testversion der XR-Lizenz oder Testversion des Mega-Service usw.) auf benutzerdefinierten Kameras oder Headsets: EasyAR Sense reagiert nicht mehr, nachdem es 100 Sekunden nach jedem Start ausgeführt wurde (Mega-Benutzer können die Dauer nach Genehmigung durch den EasyAR-Geschäftsbereich anpassen). Die Verwendung der kostenpflichtigen Version von EasyAR Sense und des kostenpflichtigen EasyAR Mega-Service unterliegt dieser Einschränkung nicht.

Installation von AR Foundation

Wir empfehlen, die offizielle AR Foundation-Dokumentation für die Installation zu konsultieren. Achten Sie beim Lesen darauf, die passende Dokumentationsversion auszuwählen.

Unity 2022 und neuere Versionen

Falls in Ihrem Projekt noch keine XR-Plugins installiert sind, müssen Sie unter Project Settings > XR Plug-in Management auf die Schaltfläche Install XR Plugin Management klicken, um XR Plug-in Management zu installieren. Warten Sie den Installationsvorgang ab.

alt text

Für die Nutzung von AR Foundation auf der Android-Plattform aktivieren Sie im Android-Tab Google ARCore und warten auf den Abschluss der Installation.

alt text

Für die Nutzung auf der iOS-Plattform aktivieren Sie im iOS-Tab Apple ARKit und warten auf den Abschluss der Installation.

alt text

Für die Nutzung auf der visionOS-Plattform lesen Sie bitte Vision Pro-Projektkonfiguration.

Tipp

Es wird empfohlen, Initialize XR On Startup aktiviert zu lassen, um sicherzustellen, dass AR Foundation zum Standardzeitpunkt initialisiert wird.

Nach der Installation sehen Sie im Fenster Package Manager die Pakete AR Foundation und die plattformspezifischen Plugins in der Liste der installierten Pakete. Stellen Sie sicher, dass deren Versionsnummern exakt übereinstimmen.

alt text

Wichtig

Bei der Installation oder Aktualisierung von AR Foundation müssen die Versionen von Google ARCore XR Plugin und Apple ARKit XR Plugin exakt mit der AR Foundation-Version übereinstimmen. Unterschiedliche Versionen können zu Laufzeitfehlern oder Funktionsstörungen führen.

Unity 2021

In Unity 2021 muss die Datei Packages/manifest.json manuell bearbeitet werden, um Versionen festzulegen. Siehe offizielle Dokumentation.

Beispiel: Um AR Foundation Version 5.2.0 für Android und iOS zu installieren, muss Packages/manifest.json folgende Einträge enthalten:

{
  "dependencies": {
    ...
    "com.unity.xr.arcore": "5.2.0",
    "com.unity.xr.arfoundation": "5.2.0",
    "com.unity.xr.arkit": "5.2.0",
    ...
  }
}

Konfiguration des XR Plug-ins

Bei der Verwendung von EasyAR ist ARCore oft nicht zwingend erforderlich. Konfigurieren Sie ARCore daher als optional, um Probleme auf nicht unterstützten Geräten zu vermeiden.

Gehen Sie unter Project Settings > XR Plug-in Management > ARCore vor und setzen Sie Requirement und Depth auf Optional.

alt text

Vorsicht

Wenn Requirement auf Required gesetzt ist und eine gebuildete Anwendung auf einem nicht unterstützten Gerät installiert wird, meldet das Gerät fälschlicherweise, dass ARCore verfügbar ist und läuft. Dies erweckt den Anschein, dass ARCore läuft aber fehlerhaft ist (z.B. schwarzer Bildschirm). Tatsächlich ist dies jedoch falsch.

Grund dafür ist, dass der Google Play Store die Installation von Apps auf nicht unterstützten Geräten blockiert, wenn ARCore als erforderlich markiert ist. Daher gehen solche Apps immer davon aus, dass sie auf kompatiblen Geräten laufen.

Bei korrekter Konfiguration erkennen solche Geräte während der Session-Initialisierung die fehlende ARCore-Unterstützung und nutzen stattdessen EasyAR-Funktionen.

Bei Bedarf können Sie zusätzliche Konfigurationen für ARCore und ARKit vornehmen. Konsultieren Sie hierfür die offizielle Dokumentation (passende Version wählen):

Konfiguration des Universal Render Pipeline

Bei Verwendung von URP muss die URP-Asset konfiguriert werden. Andernfalls wird der Kamerahintergrund von AR Foundation möglicherweise nicht korrekt gerendert.

Stellen Sie zunächst sicher, dass das EasyAR URP Renderer Feature korrekt konfiguriert ist. Siehe Konfiguration der Universal Render Pipeline für EasyAR.

Fügen Sie anschließend in der Liste der Renderer Features ARBackgroundRendererFeature hinzu.

alt text

Wie bei der EasyAR-URP-Konfiguration muss sichergestellt werden, dass unter Project Settings > Quality für alle Zielplattformen eine korrekt konfigurierte URP-Asset mit aktiviertem ARBackgroundRendererFeature verwendet wird.

Zusätzliche Hinweise finden Sie in der offiziellen URP-Konfigurationsdokumentation von AR Foundation (passende Version wählen).

Anmerkung

Die Konfiguration der Universal Render Pipeline für EasyAR bleibt weiterhin erforderlich, um die korrekte Darstellung von EasyAR-Funktionen auf Geräten ohne AR Foundation-Unterstützung sicherzustellen.

Aktivierung der EasyAR AR Foundation-Unterstützung

Gehen Sie unter Project Settings > EasyAR > Sense vor und aktivieren Sie die Option Unity XR > AR Foundation Support. Diese Option ist standardmäßig aktiviert.

alt text

Änderungen dieser Option lösen eine Neukompilierung der Skripte aus. Warten Sie den Abschluss ab. Falls Unity die Kompilierung nicht automatisch startet, schließen Sie Unity und löschen Sie den Ordner Library/ScriptAssemblies, um eine erzwungene Neukompilierung zu erzwingen.

Tipp

Falls Inkompatibilitäten zwischen EasyAR und AR Foundation im Projekt bestehen und keine parallele Nutzung erforderlich ist, kann diese Option deaktiviert werden.

Nächste Schritte

Verwandte Themen