Erste Schritte mit AR Foundation

AR Foundation von Unity ist ein plattformübergreifendes Framework, mit dem Sie einmalig Augmented-Reality-Erlebnisse schreiben und dann für Android- oder iOS-Geräte entwickeln können, ohne weitere Änderungen vorzunehmen. Das Framework ist über das AR Foundation-Paket von Unity verfügbar.

Das optionale ARCore-Paket ARCore Extensions for AR Foundation bietet zusätzliche Funktionen, mit denen du Funktionen wie Cloud Anchors, Kamerakonfigurationsfilter sowie Aufzeichnung und Wiedergabe in deiner App verwenden kannst.

Vorhandene Projekte migrieren oder upgraden

  • Informationen dazu, wie Sie ein vorhandenes Projekt vom (eingestellten) ARCore SDK für Unity zur AR Foundation und optional zu ARCore Extensions von Unity migrieren, finden Sie im Migrationsleitfaden.
  • Informationen zum Upgrade eines vorhandenen Projekts aus einer früheren Version von AR Foundation finden Sie in den Upgrade- und Migrationsleitfäden von Unity.

Voraussetzungen

Abhängig von Ihrer Zielplattform erfordert das Paket AR Foundation Folgendes:

Android

Hardware

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

Software

iOS

Hardware

Software

AR Foundation installieren

Führen Sie die folgenden Schritte aus, um das Unity-Paket AR Foundation zu installieren.

  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 die Suchleiste „AR Foundation“ ein.

  5. Klicken Sie auf Install.

Plattformspezifische Plug-in-Pakete installieren und aktivieren

Das AR Foundation-Paket bietet Unity-Entwicklern eine Schnittstelle, implementiert aber selbst keine AR-Funktionen. Wenn Sie AR Foundation auf einem Zielgerät verwenden möchten, müssen Sie außerdem separate Pakete installieren und das entsprechende Plug-in für jede einzelne Plattform aktivieren.

Android

Mit dem ARCore XR-Plug-in-Paket können Sie Augmented-Reality-Apps für Android-Geräte erstellen. Führen Sie die folgenden Schritte aus, um sie in Ihrem Unity-Projekt zu installieren, wenn Ihre Anwendung auf Android-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 die 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 sie 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 Plugin“ 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 AR Foundation-Komponenten hinzufügen

Für eine Szene ist eine AR-Sitzung erforderlich, 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 Foundation 4.x

  • AR Session: Steuert den Lebenszyklus einer AR-Umgebung.

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

Bevor du die neuen Spielobjekte hinzufügst, musst du den standardmäßigen Main Camera löschen. Er wird im AR Session Origin durch einen neuen AR Camera 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üge ein neues AR Session und ein neues AR Session Origin-Spielobjekt hinzu.

AR Foundation 5.x

  • AR Session: Steuert den Lebenszyklus einer AR-Umgebung.

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

Bevor du die neuen Spielobjekte hinzufügst, musst du den standardmäßigen Main Camera löschen. Er wird im XR Origin durch einen neuen AR Camera 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üge ein neues AR Session und ein neues XR 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 Entfernen Sie das Häkchen bei Auto Graphics API.
    Wenn Vulkan unter Graphics APIs aufgeführt ist, entfernen Sie sie, da Vulkan noch nicht von ARCore unterstützt wird.
    Other Settings > Package Name Erstelle eine eindeutige App-ID mit einem Java-Paketnamensformat.
    Verwende beispielsweise com.example.helloAR.
    Other Settings > Minimum API Level Wenn du eine App erstellst, die AR erforderlich ist, gib Android 7.0 'Nougat' (API Level 24) or higher an.
    Wenn Sie eine Anwendung mit AR Optional erstellen, geben Sie Android API Level 19 or higher an.
    Other Settings > Scripting Backend Wählen Sie IL2CPP statt Mono aus, damit im nächsten Schritt die ARM64-Unterstützung aktiviert werden kann.

    Während der Entwicklung:

    • Mono + 32-Bit (ARMv7) verwenden
    • Installiere ein FAT-ARCore-APK (32-Bit + 64-Bit)

    Beachten Sie beim Versand an den Play Store Folgendes:

    • IL2CPP“ verwenden
    • Aktivieren Sie sowohl die 32-Bit- (ARMv7) als auch die 64-Bit-Version (ARM64), um die 64-Bit-Anforderungen des Play Store zu erfüllen.
    • Optional (wird ab 2018.3 unterstützt): Aktivieren Sie in Build Settings Android App Bundles
    Other Settings > Target Architectures Aktivieren Sie 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 Gib den Namen deiner App im Reverse-DNS-Format an.
    Verwende z. B. com.mycompany.myapp.
    Other Settings > Camera usage description Gib eine Beschreibung deiner Verwendung von AR ein (z. B. ARKit).
    Other Settings > Target minimum iOS version 11.0 oder höher
    Other Settings > Architecture ARM64

Nächste Schritte