AR-Apps im Android-Emulator ausführen

Mit dem Android-Emulator können Sie AR-Szenarien ohne 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 steuern.

Entwicklungsumgebung einrichten

Softwareanforderungen:

Android Studio- und SDK-Tools für ARCore herunterladen

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

  2. Rufen Sie in Android Studio Preferences > Appearance and Behavior > System Settings > Android SDK auf.

  3. Wählen Sie den Tab SDK Platforms aus und setzen Sie ein Häkchen bei 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ählen Sie den Tab SDK Tools aus und fügen Sie 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 Komponenteninstallationsprogramm.

  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ätemanager, indem Sie auf Tools > Device Manager klicken.

  2. Klicken Sie oben im Bereich Gerätemanager auf Create Device.

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

  4. Wählen Sie ein x86- oder x86_64-Systemimage 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-Emulatorarchitekturen 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.

    • Achten Sie darauf, dass Camera Back auf VirtualScene gesetzt ist.

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

App ausführen

Testen Sie eine ARCore-App auf einem AR-fähigen virtuellen Gerät im Emulator. Folgen Sie dazu der Anleitung in Android Studio zum Ausführen einer App im Android-Emulator.

Google Play-Dienste für AR aktualisieren

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

  1. Laden Sie die neueste Google_Play_Services_for_AR_1.48.0_x86_for_emulator.apk von der GitHub-Seite Releases herunter.

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

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

    adb install -r Google_Play_Services_for_AR_1.48.0_x86_for_emulator.apk

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

Virtuelle Szene steuern

Wenn Ihre App eine Verbindung zu ARCore herstellt, wird ein Overlay mit einer Anleitung zur Kamerasteuerung und eine Statusleiste unter dem Emulatorfenster angezeigt.

Virtuelle Kamera bewegen

Halten Sie Shift gedrückt, um auf die Steuerelemente für die Kamerabewegung zuzugreifen. Mit den folgenden Steuerelementen können Sie die Kamera bewegen:

Aktion Was muss ich tun?
Nach links oder rechts verschieben Umschalttaste gedrückt halten und 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 die Taste Shift los, um im Emulator zum interaktiven Modus zurückzukehren.

Verwenden Sie den Tab Virtual Sensors unter Erweiterte Steuerelemente, um das Gerät genauer zu positionieren.

Der Szene Augmented Reality-Bilder hinzufügen

Laden Sie Bilder in die simulierte Umgebung des Emulators, um Augmented Reality-Bilder zu testen.

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

Wenn Sie diese Bildpositionen in der Szene sehen möchten, starten Sie den Emulator und bewegen Sie die Kamera durch die Tür hinter der Startposition der Kamera in den Essbereich.

Tipps zur Fehlerbehebung

  • Wenn die ARCore App gestartet wird und die Meldung „Dieses Gerät unterstützt keine AR“ angezeigt wird, prüfen Sie die Version Ihres System-Images. Verwenden Sie API-Level 27, Revision 4 oder höher.

  • Wenn die Kamera bei der Ausführung Ihrer ARCore App nicht geöffnet wird, prüfen Sie, ob Camera Back wie in den Konfigurationsschritten oben beschrieben auf VirtualScene festgelegt ist.

  • Wenn sich Ihre ARCore App nicht öffnen lässt und die Fehlermeldung „AR-Sitzung konnte nicht erstellt werden“ angezeigt wird, sehen Sie im App-Log nach. Wenn Sie ein java.lang.UnsatisfiedLinkError mit einer Meldung 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-APK installiert. Erstellen Sie ein neues virtuelles Gerät und installieren Sie die x86-Version.