Erste Schritte mit AR Foundation

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

Optionale ARCore-Funktionen ARCore-Erweiterungen für AR-Grundlagen bietet zusätzliche Funktionalität, sodass Sie Funktionen wie Cloud-Anchors, Kamera-Konfigurationsfilter sowie Aufzeichnung und Wiedergabe in Ihrem

Vorhandene Projekte migrieren oder upgraden

  • Vorhandenes Projekt aus dem eingestellten ARCore SDK für Unity migrieren auf die AR Foundation und optional ARCore-Erweiterungen von Unity zugreifen, siehe Migrationsanleitung.
  • So führen Sie ein Upgrade eines vorhandenen Projekts aus einer früheren Version von AR Foundation aus: finden Sie in der Upgrade- und Migrationsanleitungen.

Voraussetzungen

Abhängig von Ihrer Zielplattform benötigt das AR Foundation-Paket die Folgendes:

Android

Hardware

  • Ein Android-Gerät mit ARCore-Unterstützung oder Emulator
  • Ein USB-Kabel zum Verbinden Ihres Geräts mit dem Entwicklungscomputer

Software

iOS

Hardware

Software

AR Foundation installieren

Führen Sie die folgenden Schritte aus, um das Unity-Paket von 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 der Suchleiste „AR Foundation“ ein.

  5. Klicken Sie auf Install.

Plattformspezifische Plug-in-Pakete installieren und aktivieren

Das AR Foundation-Paket bietet Unity-Entwicklern eine Oberfläche, implementiert selbst keine AR-Funktionen. AR Foundation für ein Ziel verwenden installiert haben, müssen Sie auch separate Pakete installieren und den das entsprechende Plug-in für die jeweilige Plattform.

Android

Das 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 Anwendung auf Android-Geräte ausgerichtet ist. Sie müssen dieselbe Version wie das AR Foundation-Paket verwenden 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-Plug-in“ 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

ARKit XR-Plug-in ermöglicht die Entwicklung von Augmented-Reality-Apps für iOS-Geräte. 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 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-Session konfigurieren und AR Foundation-Komponenten in eine Szene einfügen

Eine Szene benötigt eine AR-Sitzung, um AR-Prozesse zu ermöglichen. wie Bewegungserkennung, Umgebungsverständnis und Belichtungsschätzung. Für eine AR-Sitzung benötigen Sie die folgenden Spielobjekte:

AR Foundation 4.x

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

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

Lösche die Standard-Main Camera, bevor du die neuen Spielobjekte hinzufügst. Es wird durch ein neues AR Camera ersetzt in der AR Session Origin.

Fügen Sie Ihrer Szene die neuen AR-Spielobjekte hinzu: Bereich Hierarchy und wählen Sie XR aus. Fügen Sie ein neue AR Session und ein neues AR Session Origin Spielobjekt.

AR Foundation 5.x

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

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

Lösche die Standard-Main Camera, bevor du die neuen Spielobjekte hinzufügst. Es wird durch ein neues AR Camera ersetzt in der XR Origin.

Fügen Sie Ihrer Szene die neuen AR-Spielobjekte hinzu: Bereich Hierarchy und wählen Sie XR aus. Fügen Sie ein neue AR Session und ein neues XR Origin Spielobjekt.

Player-Einstellungen konfigurieren

Android

  1. Rufen Sie File > Build Settings auf, um die Build Settings .
  2. Wählen Sie unter Platform die Option Android aus und klicken Sie auf Switch Platform.
  3. Klicken Sie auf Player Settings.

  4. Nehmen Sie die folgenden Änderungen vor:

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

    Während der Entwicklung:

    • Verwende Mono + 32-Bit (ARMv7)
    • Installieren Sie ein FAT (32-Bit und 64-Bit) ARCore-APK

    Beim Versand an den Play Store:

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

iOS

  1. Rufen Sie File > Build Settings auf, um die Build Settings .
  2. Wählen Sie unter Platform die Option 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üge den Namen deiner App in einem umgekehrten DNS-Format hinzu.
    Verwende beispielsweise com.mycompany.myapp.
    Other Settings > Camera usage description Beschreiben Sie Ihre Verwendung von AR (z. B. ARKit).
    Other Settings > Target minimum iOS version 11.0 oder höher
    Other Settings > Architecture ARM64

Nächste Schritte