AR-Funktionen Ihrer App im Emulator ausführen

XR‑Geräte, für die der Leitfaden gilt
Dieser Leitfaden hilft Ihnen dabei, Erlebnisse für die folgenden Arten von XR-Geräten zu entwickeln.
Audio- &
Displaybrillen

Verwenden Sie beim Testen Ihrer App den Android XR-Emulator, um Ihre Testkapazität über Ihre physischen Testgeräte hinaus zu erweitern. Mit den Emulatorsteuerungen können Sie testen, wie sich Ihre App in gängigen Szenarien mit Audio- und Displaybrillen verhält. In den folgenden Abschnitten finden Sie Informationen zum Ausführen Ihrer virtuellen Android XR-Geräte im Emulator und zu den Emulatorkonfigurationen, die Sie verwenden können.

App im Emulator ausführen

So führen Sie Ihre App im Emulator aus:

  1. Suchen Sie im Gerätemanager von Android Studio nach dem Smartphone-AVD, das Sie als Hostgerät für das Brillen-AVD erstellt haben, und klicken Sie auf Starten .

    (Klicken)

  2. Suchen Sie im Gerätemanager von Android Studio nach dem AVD für die Brille, das Sie erstellt haben, und klicken Sie auf Starten.

    (Klicken)

  3. Wenn Sie Ihre App im Emulator starten möchten, wählen Sie in der Hauptsymbolleiste von Android Studio im Drop-down-Menü für das Zielgerät das phone AVD aus und klicken Sie dann auf Ausführen.

    Android Studio-Konfiguration zum Ausführen von Apps

Emulatorsteuerung für Brillen verwenden

Mit den Emulator-Steuerelementen können Sie testen, wie sich Ihre App in gängigen Szenarien mit Audio- und Displaybrillen verhält. In den folgenden Abschnitten finden Sie weitere Informationen zu den einzelnen Steuerelementen.

Touchpadeingabe

Da Audio- und Displaybrillen keinen Touchscreen haben, erfolgt die Interaktion über ein Touchpad auf dem physischen Gerät. Beim Android XR-Emulator befindet sich das Touchpad direkt unter dem Displaybereich.

Verwenden Sie die Maus Ihres Computers im Touchpad-Bereich, um Berührungen zu simulieren, und aktivieren Sie den Modus Zwei Finger, um Touch-Gesten mit zwei Fingern auszuführen.

Die rechte Seite des Touchpad-Bereichs des Emulators entspricht dem Bereich auf einem echten Gerät, der sich vorne auf der Brille befindet (wo sich die Gläser befinden). Die linke Seite entspricht dem Bereich auf einem echten Gerät, der sich hinten auf der Brille befindet (wo die Brille auf den Ohren aufliegt). Diese Ausrichtung ist wichtig, wenn Sie Gesten wie das Wischen vorwärts oder rückwärts simulieren.

Abbildung 1. Der Touchpad-Bereich des Android XR-Emulators befindet sich direkt unter dem Displaybereich.

Spracheingabe machen

Wählen Sie in der Emulatorsteuerung Mikrofon aus, um das Mikrofon zu aktivieren oder zu deaktivieren. Dadurch wird eine Verbindung zum Emulator hergestellt und Eingaben werden über das Standardmikrofon Ihres Computers an den Emulator gesendet. Das hat denselben Effekt wie die Option Virtuelles Mikrofon verwendet Audioeingabe des Hosts in den erweiterten Emulatorsteuerungen.

Wenn das Mikrofon aktiviert ist, können Sie Hotwords und Befehle sprechen.

Abbildung 2: Aktivieren Sie das Mikrofon, um das Mikrofon Ihres Computers für die Spracheingabe zu verwenden.

Audiobrille simulieren

Wenn Sie Ihre App für Displaybrillen testen, müssen Sie eine Audiobrille simulieren, damit Ihre App sowohl Audio- als auch Displaybrillen unterstützt.

Um Ihnen das Testen für diese Anwendungsfälle zu erleichtern, können Sie in der Glasses App den Audiomodus aktivieren:

  1. Öffne im Smartphone-Emulator die Glasses App.

    Das App-Symbol für die Glasses App.

  2. Tippe auf Geräteeinstellungen und aktiviere oder deaktiviere dann Nur-Audio-Modus.

    Audiomodus über die Brille ein- oder ausschalten

  3. Beenden Sie den Smartphone-Emulator und den Brillen-Emulator.

  4. Suchen Sie in Android Studio im Device Manager (Geräte-Manager) nach dem AVD für das Smartphone und klicken Sie im Dreipunkt-Menü auf Cold Boot (Kaltstart).

    (Klicken)

  5. Folge den anderen Schritten, um den Brillenemulator neu zu starten und deine App auszuführen.

Schlummerzeitlimit für das Display deaktivieren

Das Verhalten bei Zeitüberschreitung des Displays ist ein wichtiger Aspekt bei der Entwicklung von Apps für Audio- und Displaybrillen. Wir empfehlen daher, das Standardverhalten beizubehalten, wenn Sie Ihre App wie gewohnt testen. Wenn das Display-Zeitlimit jedoch Ihre Tests beeinträchtigt, können Sie das Standardverhalten mit dem folgenden ADB-Befehl deaktivieren:

adb shell dumpsys activity service com.google.android.glasses.core/com.google.android.projection.core.app.service.AndroidProjectionCoreService preferences_set pref_automatic_snooze_timeout false

Führen Sie den folgenden ADB-Befehl aus, um das Standardverhalten für das Display-Zeitlimit wiederherzustellen:

adb shell dumpsys activity service com.google.android.glasses.core/com.google.android.projection.core.app.service.AndroidProjectionCoreService preferences_set pref_automatic_snooze_timeout true

Gemini Live verwenden

So lösen Sie Gemini Live im Brillenemulator aus:

  1. Bevor Sie Gemini Live verwenden, aktualisieren Sie die Google App auf die aktuelle Version (mindestens Version 16.46.63) im Telefonemulator:

    1. Öffnen Sie im Smartphone-Emulator die Google Play Store App.
    2. Suchen Sie nach „Google“ und wählen Sie die Google App aus.

      Aktualisieren Sie die Google App über die Google Play Store App.

    3. Wählen Sie Aktualisieren.

  2. Sie können Gemini Live über den Brillenemulator starten, indem Sie das Touchpad etwa 2 Sekunden lang berühren und halten.

    Beim ersten Mal werden dadurch eine Reihe von Berechtigungsanfragen auf Ihrem Smartphone-Emulator ausgelöst. Erteile alle erforderlichen Berechtigungen und halte dann das Touchpad auf dem Brillenemulator noch einmal etwa 2 Sekunden lang gedrückt.

    Akzeptieren Sie alle erforderlichen Berechtigungen, um Gemini Live im Brillenemulator zu verwenden.

    Wenn Gemini Live aktiv ist und zuhört, wird das im Brillenemulator so angezeigt:

    Wenn Gemini Live aktiv ist, wird auf dem Display eine visuelle Anzeige eingeblendet.

  3. Prüfe im Smartphone-Emulator, ob die Mikrofoneingabe des Hosts im Brillenemulator aktiv ist. Sie sollten eine Benachrichtigung wie die folgende sehen:

    Eine Benachrichtigung im Telefonemulator weist darauf hin, dass die Mikrofoneingabe des Hosts aktiv ist.

Benutzerdefinierte Foto-Umgebungen verwenden

Mit Fotos von realen Umgebungen können Sie testen, wie Ihre Augmented Reality-Anwendungen in diesen Szenarien mit Jetpack Compose Glimmer gerendert werden.

Das Standarddesign ist zwar bereits für helle und dunkle Umgebungen optimiert, aber markenspezifische Anpassungen müssen sorgfältig getestet werden. Testen Sie sorgfältig, damit Ihre Benutzeroberfläche auf optisch durchsichtigen Displays unabhängig von der Umgebung des Nutzers eine hohe Sichtbarkeit und einen hohen Kontrast aufweist.

So verwenden Sie ein benutzerdefiniertes Standbild als Hintergrund im Emulator:

  1. Wählen Sie in der Emulatorsteuerung Umgebungen aus.
  2. Wählen Sie im Drop-down-Menü Benutzerdefinierte Umgebung aus.

    Wählen Sie in Android Studio ein benutzerdefiniertes Bild für die Foto-Umgebung aus.

  3. Wählen Sie ein Bild aus oder wählen Sie ein zuvor verwendetes Bild aus der Liste Letzte Umgebungen aus.

    Während Sie die Benutzeroberfläche Ihrer App in der Vorschau ansehen, wird die benutzerdefinierte Umgebung im Hintergrund angezeigt.

Screenshot erstellen

Wenn Sie die visuelle Ausgabe Ihrer App im Emulator erfassen möchten, können Sie Screenshots erstellen.

Klicken Sie dazu in den Emulator-Steuerelementen auf Screenshot erstellen.

Verwenden Sie die Emulator-Steuerelemente, um einen Screenshot des Emulator-Displays in Android Studio zu erstellen.
 

Das funktioniert genauso wie das Aufnehmen von Screenshots für andere virtuelle Geräte im Android XR-Emulator. Der aufgenommene Screenshot wird als PNG-Datei gespeichert.

Bildschirmaufzeichnung erstellen

So erstellen Sie eine Bildschirmaufzeichnung Ihrer App, während sie im Emulator ausgeführt wird:

  1. Klicken Sie in der Emulatorsteuerung auf Bildschirm aufzeichnen.

    Mit den Emulator-Steuerelementen können Sie eine Bildschirmaufzeichnung der Emulatoranzeige in Android Studio erstellen.

  2. Wählen Sie „Taps anzeigen“ aus, wenn Sie Nutzerinteraktionen hervorheben möchten.

  3. Wenn Sie alles aufgenommen haben, was Sie benötigen, klicken Sie auf Aufnahme beenden.

    Eine Vorschau wird angezeigt und Sie können die Datei auf Ihrem Computer speichern.

Fotos oder Videos aufnehmen

Funktionen zur Kameraaufnahme sind im Android XR-Emulator noch nicht verfügbar.