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
- Ein von ARCore unterstütztes iOS-Gerät
- Ein USB-Kabel zum Verbinden des Geräts mit dem Entwicklungscomputer
Software
AR Foundation installieren
Führen Sie die folgenden Schritte aus, um das Unity-Paket AR Foundation zu installieren.
Öffnen Sie ein vorhandenes Unity-Projekt oder erstellen Sie ein neues 3D-Projekt.
Rufen Sie Window > Package Manager auf.
Wählen Sie neben Packages die Option Unity Registry aus.
Geben Sie in die Suchleiste „AR Foundation“ ein.
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.
Rufen Sie in Ihrem Projekt Window > Package Manager auf.
Wählen Sie neben Packages die Option Unity Registry aus.
Geben Sie in die Suchleiste „ARCore XR Plugin“ ein.
Klicken Sie auf Install.
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.
Rufen Sie in Ihrem Projekt Window > Package Manager auf.
Wählen Sie neben Packages die Option Unity Registry aus.
Geben Sie in der Suchleiste „ARKit XR Plugin“ ein.
Klicken Sie auf Install.
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
- Rufen Sie File > Build Settings auf, um das Fenster Build Settings zu öffnen.
- Wählen Sie unter Platform Android aus und klicken Sie auf Switch Platform.
- Klicken Sie auf Player Settings.
Ü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 beispielsweisecom.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
- Rufen Sie File > Build Settings auf, um das Fenster Build Settings zu öffnen.
- Wählen Sie unter Platform iOS aus und klicken Sie auf Switch Platform.
- Klicken Sie auf Player Settings.
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
- Erste Schritte mit dem optionalen ARCore Extensions-Paket, das zusätzliche ARCore-Funktionen für das AR Foundation Framework bietet
- Erstelle ein AR-Spiel mit der AR Foundation von Unity (Codelab).