Erste Schritte mit ARCore-Erweiterungen für AR Foundation

Mit den optionalen ARCore-Erweiterungen für AR Foundation können Sie das AR Foundation-Paket von Unity um Funktionen wie Cloud Anchors, Kamerakonfigurationsfilter und Aufzeichnung und Wiedergabe in Ihrer App erweitern.

Voraussetzungen

Für die Entwicklung mit ARCore-Erweiterungen für AR Foundation benötigen Sie Folgendes:

Android

Hardware

Software

iOS

Hardware

Software

ARCore-Erweiterungspaket installieren

Folge dieser Anleitung, um ARCore-Erweiterungen für AR Foundation zu installieren.

Gebündelte Abhängigkeiten

  1. Achten Sie darauf, dass AR Foundation in Ihrer Entwicklungsumgebung installiert und konfiguriert ist.
  2. Öffnen oder erstellen Sie ein neues Unity-Projekt.
  3. Wählen Sie die gewünschte Ziel-Build-Plattform aus:
    1. Wählen Sie im File-Menü die Option Build Settings aus.
    2. Wählen Sie abhängig von der gewünschten Zielplattform Android oder iOS aus.
    3. Klicken Sie auf Switch Platform.

  4. Importieren Sie das neueste ARCore-Erweiterungspaket:

    1. Rufen Sie Window > Package Manager auf.

    2. Klicken Sie auf die Schaltfläche und wählen Sie im Drop-down-Menü die Option Add package from git URL... aus.

    3. Fügen Sie die folgende URL in das Textfeld ein:

      https://github.com/google-ar/arcore-unity-extensions.git

    4. Klicken Sie auf Add.

Ohne EDM4U

Standardmäßig sind ARCore-Erweiterungen mit zusätzlichen Abhängigkeiten gebündelt. Wenn Sie andere Bibliotheken (z. B. Firebase Analytics) verwenden, die von einer anderen Version von External Dependency Manager for Unity abhängig sind, kann undefiniertes Verhalten auftreten, wodurch abhängige Elemente nicht mehr richtig funktionieren.

Installieren Sie ARCore-Erweiterungen ohne gebündelte Abhängigkeiten, um Konflikte bei der Bibliotheksversionierung zu vermeiden:

  1. Laden Sie die ARCore-Erweiterungen ohne EDM4U-Release und com.google.external-dependency-manager herunter.
  2. Folgen Sie der Anleitung zum Importieren von UPM-Paketen mit .tgz-Dateien und installieren Sie die Pakete in der folgenden Reihenfolge:
    1. com.google.external-dependency-manager,
    2. ARCore-Erweiterungen (ohne EDM4U)

Bei der Installation von ARCore Extensions installiert Unity automatisch auch eine geeignete Version der erforderlichen Abhängigkeiten:

  • AR Foundation
  • ARCore XR Plugin (wird bei der Ausrichtung auf Android verwendet)
  • ARKit XR Plugin (bei Ausrichtung auf iOS verwendet)

Diese Abhängigkeiten sind in der Ansicht Package Manager > Package: In project möglicherweise nicht sichtbar. Sie können die Pakete jedoch im Fenster Project unter Packages ansehen.

ARCore-Erweiterungen einrichten

AR Foundation 4.x

  1. Klicken Sie im Bereich Hierarchy mit der rechten Maustaste und fügen Sie die folgenden Spielobjekte hinzu (falls noch nicht vorhanden):

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions

  2. Wählen Sie im Bereich Hierarchy das Paket ARCore Extensions aus.

  3. Klicken Sie im Bereich Inspector bei jedem der folgenden Felder auf die Zielschaltfläche und verbinden Sie jedes Feld so mit dem entsprechenden Spielobjekt:

    • Session: AR Session deiner Szene verwenden.
    • AR Session Origin: AR Session Origin der Szene verwenden.
    • Camera Manager: AR Camera deiner Szene verwenden.

  4. Erstellen Sie optional die folgenden Assets für Cloud-Anchors und Kamerakonfigurationsfilter und verbinden Sie sie.

    1. Klicken Sie im Bereich Project > Assets mit der rechten Maustaste und wählen Sie Create > XR > ARCore Extensions Config aus.

    2. Klicken Sie im Bereich Project > Assets mit der rechten Maustaste und wählen Sie Create > XR > Camera Config Filter aus.

    3. Wählen Sie im Bereich Hierarchy das Paket ARCore Extensions aus.

    4. Klicken Sie im Feld ARCore Extensions Config im Bereich Inspector auf die Zielschaltfläche und stellen Sie eine Verbindung zum Asset ARCoreExtensionsConfig her.

    5. Klicken Sie im Feld Camera Config Filter im Bereich Inspector auf die Zielschaltfläche und stellen Sie eine Verbindung zum Asset ARCoreExtensionsCameraConfigFilter her.

      Weitere Informationen finden Sie im Entwicklerhandbuch für Cloud-Anker und im Leitfaden zum Konfigurieren der Kamera.

    6. Wenn Sie eine Unity-Version vor 2020.3 verwenden:

      • Wählen Sie unter Project Settings > Player > Android > Publishing Settings > Build (Projekteinstellungen > Player > Android > Publishing Settings > Build) die Option Custom Gradle Properties Template aus.

Wenn alle oben genannten ARCore Extensions-Felder ordnungsgemäß verbunden sind, sieht der Bereich Inspector der ARCore-Erweiterungen so aus:

AR Foundation 5.x

  1. Klicken Sie im Bereich Hierarchy mit der rechten Maustaste und fügen Sie die folgenden Spielobjekte hinzu (falls noch nicht vorhanden):

    • XR > AR Session
    • XR > XR Origin (Mobile AR)
    • XR > ARCore Extensions

  2. Wählen Sie im Bereich Hierarchy das Paket ARCore Extensions aus.

  3. Klicken Sie im Bereich Inspector bei jedem der folgenden Felder auf die Zielschaltfläche und verbinden Sie jedes Feld so mit dem entsprechenden Spielobjekt:

    • Session: AR Session deiner Szene verwenden.
    • XR Origin: XR Origin der Szene verwenden.
    • Camera Manager: AR Camera deiner Szene verwenden.

  4. Erstellen Sie optional die folgenden Assets für Cloud-Anchors und Kamerakonfigurationsfilter und verbinden Sie sie.

    1. Klicken Sie im Bereich Project > Assets mit der rechten Maustaste und wählen Sie Create > XR > ARCore Extensions Config aus.

    2. Klicken Sie im Bereich Project > Assets mit der rechten Maustaste und wählen Sie Create > XR > Camera Config Filter aus.

    3. Wählen Sie im Bereich Hierarchy das Paket ARCore Extensions aus.

    4. Klicken Sie im Feld ARCore Extensions Config im Bereich Inspector auf die Zielschaltfläche und stellen Sie eine Verbindung zum Asset ARCoreExtensionsConfig her.

    5. Klicken Sie im Feld Camera Config Filter im Bereich Inspector auf die Zielschaltfläche und stellen Sie eine Verbindung zum Asset ARCoreExtensionsCameraConfigFilter her.

      Weitere Informationen finden Sie im Entwicklerhandbuch für Cloud-Anker und im Leitfaden zum Konfigurieren der Kamera.

    6. Wenn Sie eine Unity-Version vor 2020.3 verwenden:

      • Wählen Sie unter Project Settings > Player > Android > Publishing Settings > Build (Projekteinstellungen > Player > Android > Publishing Settings > Build) die Option Custom Gradle Properties Template aus.

Wenn alle oben genannten ARCore Extensions-Felder ordnungsgemäß verbunden sind, sieht der Bereich Inspector der ARCore-Erweiterungen so aus:

Weitere Informationen zum Einrichten von Eigenschaften finden Sie im Unity-Leitfaden zum Bearbeiten von Eigenschaften.

Beispielprojekte

Im Bundle mit ARCore Extensions for AR Foundation kannst du Beispielprojekte für deine eigenen Projekte verwenden.

  1. Öffnen Sie im Menü Window den Package Manager und wählen Sie das Paket ARCore Extensions aus.

  2. Klicken Sie unter Samples für das unten beschriebene Beispielprojekt auf Import.

Die folgenden Beispielprojekte werden aus dem GitHub-Repository importiert:

  • Raumbezogen (nur für Android): AR-Erlebnisse auf der ganzen Welt erstellen und per Fernzugriff Inhalte mit beliebigen Bereichen von Google Street View verknüpfen Weitere Informationen finden Sie in der Einführung zur Geospatial API.

  • PersistentCloudAnchors (Android und iOS): Erstellen Sie persistente AR-Erlebnisse in der realen Welt mit interaktiven Ebenen digitaler Informationen, die an tatsächlichen Orten verankert sind, und entwerfen Sie Erlebnisse, die im Laufe der Zeit von mehreren Personen auf vielen verschiedenen Geräten geteilt werden können. Weitere Informationen finden Sie in der Einführung in Cloud Anchors.

Nächste Schritte

Mit ARCore-Erweiterungen für AR Foundation können Sie jetzt Cloud Anchors und Kamerakonfigurationen in Ihren Apps verwenden.