Erste Schritte mit AR Foundation

Die AR Foundation von Unity ist ein plattformübergreifendes Framework, mit dem Sie Augmented Reality einmalig schreiben und dann für Android- oder iOS-Geräte erstellen können, ohne zusätzliche Änderungen vornehmen zu müssen. Das Framework ist über das Paket AR Foundation von Unity verfügbar.

Das optionale ARCore Extensions-Paket für AR Foundation bietet zusätzliche Funktionen, mit denen Sie Funktionen wie Cloud Anchors, Kamerakonfigurationsfilter und die Aufzeichnung und Wiedergabe in Ihrer App nutzen können.

Vorhandene Projekte migrieren oder upgraden

  • Informationen zum Migrieren eines vorhandenen Projekts aus dem (eingestellten) ARCore SDK für Unity zur AR Foundation von Unity und optional zu ARCore-Erweiterungen finden Sie in der Migrationsanleitung.
  • Informationen zum Upgrade eines vorhandenen Projekts von einer früheren Version von AR Foundation finden Sie in den Upgrade- und Migrationsleitfäden von Unity.

Voraussetzungen

Je nach Zielplattform erfordert das Paket AR Foundation Folgendes:

Android

Hardware

  • Ein ARCore-unterstütztes Android-Gerät oder einen Emulator
  • Ein USB-Kabel zum Verbinden des Geräts mit dem Entwicklungsgerät

Software

iOS

Hardware

Software

AR Foundation installieren

So installieren Sie das Unity-Paket für AR Foundation:

  1. Öffnen Sie ein vorhandenes Unity-Projekt oder erstellen Sie ein neues 3D-Projekt.

  2. Rufen Sie Window > Package Manager auf.

  3. Wählen Sie neben Packages die Option Unity Registry aus.

  4. Geben Sie in der Suchleiste „AR Foundation“ ein.

  5. Klicken Sie auf Install.

Plattformspezifische Plug-in-Pakete installieren und aktivieren

Das AR Foundation Package bietet Unity-Entwicklern eine Schnittstelle, implementiert jedoch keine AR-Features selbst. Wenn Sie AR Foundation auf einem Zielgerät verwenden möchten, müssen Sie auch separate Pakete installieren und das entsprechende Plug-in für die jeweilige Plattform aktivieren.

Android

Mit dem ARCore XR-Plug-in können Sie Augmented-Reality-Apps für Android-Geräte erstellen. Führen Sie die folgenden Schritte aus, um es in Ihrem Unity-Projekt zu installieren, wenn Ihre App auf Android-Geräte ausgerichtet ist. Verwende dieselbe Version wie das AR Foundation-Paket, um Kompatibilitätsprobleme zu vermeiden.

  1. Rufen Sie in Ihrem Projekt Window > Package Manager auf.

  2. Wählen Sie neben Packages die Option Unity Registry aus.

  3. Geben Sie in der Suchleiste „ARCore XR plugin“ ein.

  4. Klicken Sie auf Install.

  5. Rufen Sie Edit > Project Settings auf. Öffnen Sie in XR Plug-in Management den Tab Android und aktivieren Sie ARCore.

iOS

Mit dem ARKit-XR-Plug-in können Sie Augmented-Reality-Apps für iOS-Geräte erstellen. Führen Sie die folgenden Schritte aus, um es in Ihrem Unity-Projekt zu installieren, wenn Ihre Anwendung auf iOS-Geräte ausgerichtet ist. Verwenden Sie dieselbe Version wie das AR Foundation-Paket, um Kompatibilitätsprobleme zu vermeiden.

  1. Rufen Sie in Ihrem Projekt Window > Package Manager auf.

  2. Wählen Sie neben Packages die Option Unity Registry aus.

  3. Geben Sie in der Suchleiste „ARKit XR-Plug-in“ ein.

  4. Klicken Sie auf Install.

  5. Rufen Sie Edit > Project Settings auf. Öffnen Sie in XR Plug-in Management den Tab iOS und aktivieren Sie ARKit.

AR-Sitzung konfigurieren und Ihrer Szene AR-Komponenten hinzufügen

Eine Szene erfordert eine AR-Sitzung, um AR-Prozesse wie Bewegungserkennung, Umgebungsverständnis und Lichtschätzung zu ermöglichen. Sie benötigen die folgenden Spielobjekte, um eine AR-Sitzung zu unterstützen:

  • AR Session: Steuert den Lebenszyklus eines AR-Erlebnisses.

  • AR Session Origin: Wandelt AR-Koordinaten in Unity-Weltkoordinaten um.

Löschen Sie vor dem Hinzufügen der neuen Spielobjekte die Standard-Main Camera. Sie wird durch eine neue AR Camera im AR Session Origin ersetzt.

Fügen Sie Ihrer Szene die neuen AR-Spielobjekte hinzu: Klicken Sie mit der rechten Maustaste auf den Bereich Hierarchy und wählen Sie XR aus. Fügen Sie ein neues AR Session- und ein neues AR Session Origin-Spielobjekt hinzu.

Player-Einstellungen konfigurieren

Android

  1. Rufen Sie File > Build Settings auf, um das Fenster Build Settings zu öffnen.
  2. Wählen Sie unter Platform Android aus und klicken Sie auf Switch Platform.
  3. Klicken Sie auf Player Settings.

  4. Übernehmen Sie die folgenden Änderungen:

    Player Settings > … Wert
    Other Settings > Rendering Deaktivieren Sie Auto Graphics API.
    Wenn Vulkan unter Graphics APIs aufgeführt ist, entfernen Sie es, da Vulkan noch nicht von ARCore unterstützt wird.
    Other Settings > Package Name Erstellen Sie eine eindeutige App-ID im Format eines Java-Paketnamens.
    Verwenden Sie beispielsweise com.example.helloAR.
    Other Settings > Minimum API Level Wenn Sie eine App für AR erforderlich erstellen, geben Sie Android 7.0 'Nougat' (API Level 24) or higher an.
    Wenn Sie eine AR-optionale App erstellen, geben Sie Android API Level 19 or higher an.
    Other Settings > Scripting Backend Wählen Sie IL2CPP anstelle von Mono aus, damit im nächsten Schritt die ARM64-Unterstützung aktiviert wird.

    Während der Entwicklung:

    • Mono + 32-Bit (ARMv7) verwenden
    • ARCore-APK (32-Bit + 64-Bit) installieren

    Beim Versand in den Play Store:

    • „IL2CPP“ verwenden
    • Aktiviere sowohl 32-Bit (ARMv7) als auch 64-Bit (ARM64), um die 64-Bit-Anforderungen von Play Store zu erfüllen
    • Optional (ab 2018.3): Aktivieren Sie in Build Settings Android App Bundles
    Other Settings > Target Architectures Aktiviere ARM64 (64-Bit-ARM), um die 64-Bit-Anforderung von Google Play zu erfüllen. Lassen Sie ARMv7 (32-Bit-ARM) aktiviert, um 32-Bit-Geräte zu unterstützen.

iOS

  1. Rufen Sie File > Build Settings auf, um das Fenster Build Settings zu öffnen.
  2. Wählen Sie unter Platform iOS aus und klicken Sie auf Switch Platform.
  3. Klicken Sie auf Player Settings.

  4. Legen Sie folgende Einstellungen fest:

    Player Settings > … Wert
    Other Settings > Bundle Identifier Fügen Sie den Namen Ihrer App in einem umgekehrten DNS-Format hinzu.
    Verwenden Sie beispielsweise com.mycompany.myapp.
    Other Settings > Camera usage description Geben Sie eine Beschreibung ein, um Ihre Verwendung von AR zu erläutern (z. B. ARKit).
    Other Settings > Target minimum iOS version 11.0 oder höher
    Other Settings > Architecture ARM64

Nächste Schritte