AR-Apps im Android-Emulator ausführen

Mit dem Android-Emulator können Sie AR-Szenarien ohne ein physisches Gerät testen. Mit dem Android-Emulator können Sie ARCore-Apps in einer virtuellen Umgebung mit einem emulierten Gerät ausführen, das Sie selbst steuern.

Entwicklungsumgebung einrichten

Softwareanforderungen:

Android Studio und SDK-Tools für ARCore herunterladen

  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ählen Sie den Tab SDK Platforms aus und klicken Sie das Kästchen Show Package Details an.

    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 finden Sie die Lizenzvereinbarung für das Component Installer.

  8. Klicken Sie auf Finish.

Virtuelles Gerät mit AR-Unterstützung erstellen

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

Neues virtuelles Android-Gerät (AVD) erstellen

  1. Öffnen Sie in Android Studio den Geräte-Manager, indem Sie auf Tools > Device Manager klicken.

  2. Klicken Sie oben im Geräte-Manager auf Create Device.

  3. Wählen oder erstellen Sie das gewünschte Telefon-Hardwareprofil und wählen Sie Next aus.

  4. Wählen Sie ein x86- oder x86_64-System-Image mit API-Level 27 oder höher und dann Next aus.

    • Physische ARCore-Geräte werden ab API-Level 24 unterstützt. Für die Unterstützung des Android-Emulators ist jedoch API-Level 27 oder höher erforderlich.

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

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

    • Klicken Sie auf Show Advanced Settings.

    • Camera Back muss auf VirtualScene gesetzt sein.

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

App ausführen

ARCore-App auf einem AR-unterstützten virtuellen Gerät im Emulator testen Folgen Sie dazu der Anleitung für Android Studio unter App im Android-Emulator ausführen.

Google Play-Dienste für AR aktualisieren

Die Version der Google Play-Dienste für AR auf dem Emulator ist wahrscheinlich veraltet. Führen Sie zum Aktualisieren die folgenden Schritte aus:

  1. Laden Sie die aktuelle Version von Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk von der GitHub-Seite für Releases herunter.

  2. Installieren Sie das heruntergeladene APK in jedem AVD, das Sie verwenden möchten:

    Starten Sie das gewünschte AVD und ziehen Sie dann das heruntergeladene APK aus dem Systemordner (z.B. Downloads) auf den laufenden Emulator herunterladen oder ihn mit adb installieren, während das virtuelle Gerät ausgeführt wird: 

    adb install -r Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk

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

Virtuelle Szene steuern

Wenn deine App eine Verbindung zu ARCore herstellt, werden ein Overlay mit einer Beschreibung der Kamerasteuerung und eine Statusleiste unter dem Emulatorfenster angezeigt.

Virtuelle Kamera bewegen

Halte Shift gedrückt, um auf die Steuerung der Kamerabewegung zuzugreifen. Mit den folgenden Steuerelementen kannst du die Kamera bewegen:

Aktion Deine Aufgabe:
Nach links oder rechts bewegen Umschalttaste gedrückt halten + A oder D drücken
Nach unten oder oben verschieben Umschalttaste gedrückt halten und Q oder E drücken
Vorwärts und rückwärts bewegen Umschalttaste gedrückt halten und W oder S drücken
Geräteausrichtung ändern Umschalttaste gedrückt halten und Maus bewegen

Lassen Sie Shift los, um zum interaktiven Modus im Emulator zurückzukehren.

Verwenden Sie den Tab Virtual Sensors unter Erweiterte Steuerelemente, um eine genauere Gerätepositionierung zu erreichen.

Erweiterte Bilder zur Szene hinzufügen

Laden Sie 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 Aufnahmeorte: einen an der Wand und einer auf dem Tisch.

Um diese Bildorte in der Szene zu sehen, starten Sie den Emulator und bewegen Sie die Kamera dann durch die Tür hinter der Startposition der Kamera in den Esszimmerbereich.

Tipps zur Fehlerbehebung

  • Wenn Ihre ARCore-App gestartet wird und die Meldung „Dieses Gerät unterstützt AR nicht“ angezeigt wird, prüfen Sie die Version auf Ihrem System-Image. Achten Sie darauf, dass Sie API-Level 27 Version 4 oder höher verwenden.

  • Wenn die ARCore-App die Kamera beim Start nicht öffnen kann, prüfen Sie, ob Camera Back auf VirtualScene gesetzt ist, wie in den oben beschriebenen Konfigurationsschritten beschrieben.

  • Wenn Ihre ARCore-App nicht geöffnet werden kann und die Fehlermeldung „Failed to create AR session“ (AR-Sitzung konnte nicht erstellt werden) nicht geöffnet wird, prüfen Sie das App-Log. Wenn Sie ein java.lang.UnsatisfiedLinkError mit einer Nachricht finden, die /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3) enthält, haben Sie möglicherweise die falsche Version der Google Play-Dienste für AR installiert. Erstellen Sie ein neues virtuelles Gerät und installieren Sie die x86-Version.