AR-Apps im Android-Emulator ausführen

Mit dem Android-Emulator kannst du AR-Szenarien ohne physisches Gerät testen. Mit dem Android-Emulator kannst du ARCore-Apps in einer virtuellen Umgebung mit einem emulierten Gerät ausführen.

Entwicklungsumgebung einrichten

Softwareanforderungen:

Android Studio und SDK-Tools für ARCore nutzen

  1. Installieren Sie Android Studio 3.1 oder höher.

  2. Rufe in Android Studio „Preferences > Appearance and Behavior > System Settings > Android SDK“ auf.

  3. Wähle den Tab SDK Platforms aus und klicke dann auf das Kästchen neben Show Package Details.

    Wählen Sie unter der entsprechenden Android-Version Folgendes aus:
    Google APIs Intel x86 Atom System Image API-Level 27 oder höher

  4. Wähle den Tab SDK Tools aus und füge Android Emulator 27.2.9 oder höher hinzu.

  5. Klicken Sie auf OK, um die ausgewählten Pakete und Tools zu installieren.

  6. Klicken Sie noch einmal auf OK, um die Änderungen zu bestätigen.

  7. Accept die Lizenzvereinbarung für das Installationsprogramm für Komponenten.

  8. Klicken Sie auf Finish.

Virtuelles Gerät mit AR-Unterstützung erstellen

Weitere Informationen findest du in der Android Studio-Anleitung zum Erstellen eines virtuellen Geräts.

Neues virtuelles Android-Gerät erstellen

  1. Öffnen Sie in Android Studio den AVD-Manager, indem Sie auf Tools > AVD Manager klicken.

  2. Klicken Sie unten im Dialogfeld AVD Manager auf Create Virtual Device.

  3. Wähle das gewünschte Telefon-Hardwareprofil aus oder erstelle eines und wähle Next aus.

  4. Wähle ein System-Image für x86 oder x86_64 mit API-Level 27 oder höher und dann Next aus.

    • Während physische ARCore-Geräte auf API-Level 24 oder höher unterstützt werden, ist für Android-Emulator-Unterstützung API-Level 27 oder höher erforderlich.

    • Nur x86-basierte Android-Emulator-Architekturen werden unterstützt. Andere Architekturen wie arm64-v8a und armeabi-v7 werden derzeit nicht unterstützt.

  5. Prüfen Sie, ob Ihr virtuelles Gerät korrekt konfiguriert ist:

    • Klicken Sie auf Show Advanced Settings.

    • Camera Back muss auf VirtualScene festgelegt sein.

  6. Klicken Sie auf Finish, um Ihren AVD zu erstellen.

App ausführen

Wenn Sie eine ARCore-App auf einem AR-unterstützten Gerät im Emulator testen möchten, Dazu kannst du der Anleitung für Android Studio folgen, um eine App im Android Emulator auszuführen.

Google Play-Dienste für AR aktualisieren

Die Version der Google Play-Dienste für AR im Emulator ist wahrscheinlich veraltet. So aktualisieren Sie sie:

  1. Laden Sie die neueste Version von Google_Play_Services_for_AR_1.32.0_x86_for_Emulator.apk von der GitHub-Release-Seite herunter.

  2. Installieren Sie die heruntergeladene APK-Datei in jedem AVD, den Sie verwenden möchten:

    Starten Sie den gewünschten AVD und ziehen Sie dann das heruntergeladene APK aus dem Systemordner (z.B. Downloads) auf den ausgeführten Emulator oder montiere es mithilfe von adb, während das virtuelle Gerät ausgeführt wird:

    adb install -r Google_Play_Services_for_AR_1.32.0_x86_for_emulator.apk

Wiederholen Sie diese Schritte für alle weiteren AVDs, die Sie verwenden möchten.

Die virtuelle Szene steuern

Wenn deine App eine Verbindung zu ARCore herstellt, wird ein Overlay angezeigt, das die Steuerung der Kamera und eine Statusleiste unter dem Emulator-Fenster beschreibt.

Virtuelle Kamera verschieben

Halte Option (macOS) oder Alt (Linux oder Windows) gedrückt, um auf die Kamerabewegungssteuerungen zuzugreifen. Verwenden Sie die folgenden Steuerelemente, um die Kamera zu bewegen:

Plattform Aktion Was muss ich tun?
macOS Nach links oder rechts verschieben Wahltaste gedrückt halten und A oder D drücken
Nach unten oder oben verschieben Wahltaste gedrückt halten und Q oder E drücken
Vorwärts und rückwärts bewegen Wahltaste gedrückt halten und W oder S drücken
Ausrichtung des Geräts ändern Wahltaste gedrückt halten und die Maus bewegen
Linux oder Windows Nach links oder rechts verschieben Alt gedrückt halten und A oder D drücken
Nach unten oder oben verschieben Alt gedrückt halten und Q oder E drücken
Vorwärts und rückwärts bewegen Alt gedrückt halten und W oder S drücken
Ausrichtung des Geräts ändern Alt gedrückt halten und die Maus bewegen

Lassen Sie Option oder Alt los, um zum interaktiven Modus im Emulator zurückzukehren.

Für eine präzisere Positionierung des Geräts kannst du den Tab Virtual Sensors unter Erweiterte Steuerelemente verwenden.

Erweiterte Bilder in die Szene einfügen

Lade Bilder in die simulierte Umgebung des Emulators, um erweiterte Bilder zu testen.

Verwenden Sie den Tab Camera in Extended controls, um Scene images hinzuzufügen oder zu ändern. Es gibt zwei Bilderpositionen: eine an der Wand und eine auf dem Tisch.

Wenn du diese Bildpositionen im Bild sehen möchtest, starte deinen Emulator und bewege die Kamera dann in den Speiseraum, indem du sie hinter der Ausgangsposition der Kamera öffnest.

Tipps zur Fehlerbehebung

  • Wenn deine ARCore-App gestartet wird und du die Meldung „Dieses Gerät unterstützt keine AR-Nachricht“ siehst, prüfe die Überarbeitung auf deinem System-Image. Achte darauf, dass du API-Level 27 Überarbeitung 4 oder höher verwendest.

  • Wenn sich die ARCore-App beim Starten der Kamera nicht öffnen lässt, musst du Camera Back auf VirtualScene setzen, wie in den Schritten zur Konfiguration oben beschrieben.

  • Wenn Ihre ARCore-Anwendung nicht geöffnet werden kann und die Fehlermeldung „Fehler beim Erstellen der AR-Sitzung“ angezeigt wird, prüfen Sie das App-Protokoll. Wenn du eine java.lang.UnsatisfiedLinkError mit einer Nachricht findest, die /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3) enthält, hast du möglicherweise die falsche Version der APK-Datei Google Play Services for AR installiert. Erstelle ein neues virtuelles Gerät und installiere die x86-Version.