Esegui le esperienze di realtà aumentata della tua app sull'emulatore

Dispositivi XR applicabili
Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.
Audio e
occhiali con display

Durante il test dell'app, utilizza l'emulatore Android XR per estendere la capacità di test oltre i dispositivi di test fisici. Puoi utilizzare i controlli dell'emulatore per testare il comportamento della tua app in scenari comuni con occhiali audio e occhiali con display. Consulta le sezioni seguenti per informazioni dettagliate sull'esecuzione dei dispositivi Android XR virtuali nell'emulatore e sui controlli dell'emulatore che puoi utilizzare.

Esegui l'app sull'emulatore

Per eseguire l'app sull'emulatore, segui questi passaggi:

  1. In Gestione dispositivi di Android Studio, trova l'AVD dello smartphone che hai creato per fungere da dispositivo host per l'AVD degli occhiali e fai clic su Avvia.

    Clic

  2. In Gestione dispositivi di Android Studio, trova l'AVD degli occhiali che hai creato e fai clic su Avvia.

    Clic

  3. Per avviare l'app nell'emulatore, seleziona l'AVD dello smartphone dal menu a discesa del dispositivo di destinazione nella barra degli strumenti principale di Android Studio, quindi fai clic su Esegui.

    Configurazione dell'app di esecuzione di Android Studio

Utilizza i controlli dell'emulatore per gli occhiali

Utilizza i controlli dell'emulatore per testare il comportamento della tua app in scenari comuni con occhiali audio e occhiali con display. Consulta le sezioni seguenti per maggiori dettagli su ciascuno dei controlli che puoi utilizzare.

Fornisci input touchpad

Poiché gli occhiali audio e gli occhiali con display non hanno un touchscreen, le interazioni utilizzano un touchpad sul dispositivo fisico. Per l'emulatore Android XR, puoi trovare il touchpad appena sotto l'area di visualizzazione.

Utilizza il mouse del computer nell'area del touchpad per simulare il tocco e attiva la modalità Due dita per eseguire i gesti con due dita.

Il lato destro dell'area del touchpad dell'emulatore rappresenta l'area di un dispositivo reale che si trova verso la parte anteriore degli occhiali (dove si trovano le lenti), mentre il lato sinistro rappresenta l'area di un dispositivo reale che si trova verso la parte posteriore degli occhiali (dove gli occhiali poggiano sulle orecchie). Conoscere questo orientamento è importante quando si simulano gesti come lo scorrimento in avanti o indietro.

Figura 1. L'area del touchpad sull'emulatore Android XR si trova appena sotto l'area di visualizzazione.

Fornisci input vocale

Per attivare/disattivare il microfono, seleziona Microfono dai controlli dell'emulatore. In questo modo, l'emulatore si connette e riceve l'input utilizzando il dispositivo di input del microfono predefinito del computer. Questo ha lo stesso effetto dell'utilizzo dell'opzione Il microfono virtuale utilizza l'input audio dell'host nei controlli estesi dell'emulatore.

Quando il microfono è attivo, parla per utilizzare le hotword e impartire comandi.

Figura 2. Attiva il microfono per utilizzare il microfono del computer per l'input vocale.

Simula occhiali audio

Durante il test della tua app per gli occhiali con display, dovrai simulare un paio di occhiali audio in modo che la tua app possa supportare sia gli occhiali audio che gli occhiali con display.

Per aiutarti a eseguire i test per questi casi d'uso, l'app Glasses ti consente di attivare la modalità solo audio:

  1. Nell'emulatore dello smartphone, apri l'app Glasses.

    L'icona dell'app Glasses.

  2. Tocca Impostazioni del dispositivo, quindi attiva o disattiva la Modalità solo audio.

    Attiva/disattiva la modalità solo audio tramite gli occhiali .

  3. Arresta l'emulatore dello smartphone e l'emulatore degli occhiali.

  4. In Gestione dispositivi di Android Studio, trova l'AVD dello smartphone e fai clic su Avvio a freddo nel menu extra.

    Clic

  5. Segui gli altri passaggi per riavviare l'emulatore degli occhiali ed eseguire l'app.

Disattiva il timeout di posticipo del display

Il comportamento di timeout del display è un aspetto importante da considerare quando sviluppi le esperienze della tua app per gli occhiali audio e gli occhiali con display. Per questo motivo, ti consigliamo di lasciare il comportamento predefinito durante i test dell'app. Tuttavia, nei casi in cui il timeout del display interferisce con i test, puoi disattivare il comportamento predefinito utilizzando il seguente comando ADB:

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

Per ripristinare il comportamento predefinito del timeout del display, esegui il seguente comando ADB:

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

Usa Gemini Live

Segui questi passaggi per attivare Gemini Live nell'emulatore degli occhiali:

  1. Prima di provare a utilizzare Gemini Live, aggiorna l'app Google all'ultima versione (la versione minima richiesta è la 16.46.63) sull'emulatore dello smartphone:

    1. Nell'emulatore dello smartphone, apri l'app Google Play Store.
    2. Cerca "Google" e seleziona l'app Google.

      Aggiorna l'app Google dall'app Google Play Store.

    3. Seleziona Aggiorna.

  2. Attiva Gemini Live dall'emulatore degli occhiali toccando e tenendo premuto il touchpad per circa 2 secondi.

    La prima volta, verrà attivata una serie di richieste di autorizzazione sull'emulatore dello smartphone. Concedi tutte le autorizzazioni richieste, quindi tocca e tieni premuto di nuovo il touchpad sull'emulatore degli occhiali per circa 2 secondi.

    Accetta tutte le autorizzazioni richieste per utilizzare Gemini Live sull'emulatore
degli occhiali.

    Quando Gemini Live è attivo e in ascolto, vedrai questo sull'emulatore degli occhiali:

    Quando Gemini Live è attivo, sul display viene visualizzato un indicatore visivo.

  3. Verifica che l'ingresso del microfono dell'host sia attivo sull'emulatore degli occhiali guardando l'emulatore dello smartphone. Dovresti visualizzare una notifica simile alla seguente:

    Una notifica sull'emulatore dello smartphone indica che l'input del microfono host è attivo.

Utilizza ambienti personalizzati

Puoi eseguire test utilizzando foto di ambienti reali (incluse immagini 2D fisse e immagini panoramiche a 360 gradi) o dati fotocamera della webcam per valutare il rendering delle tue esperienze di realtà aumentata in questi scenari utilizzando Jetpack Compose Glimmer.

Sebbene il tema predefinito sia pre-ottimizzato per ambienti chiari e scuri, le personalizzazioni specifiche del brand richiedono un nuovo test accurato. Esegui test accurati per assicurarti che la tua UI mantenga un'elevata visibilità e un contrasto elevato sui display ottici trasparenti, indipendentemente dall'ambiente dell'utente.

Per utilizzare un'immagine fissa personalizzata o i dati della webcam come sfondo nell'emulatore:

  1. Seleziona Ambienti dai controlli dell'emulatore.
  2. Nel menu a discesa, seleziona Ambiente personalizzato per le immagini personalizzate caricate o Fotocamera per i dati della webcam.

    Seleziona un'immagine personalizzata dell'ambiente fotografico o i dati della fotocamera della webcam in Android Studio.

  3. Per gli ambienti personalizzati, scegli un'immagine da utilizzare o seleziona un'immagine utilizzata in precedenza dall'elenco Ambienti recenti.

    Durante l'anteprima della UI dell'app, l'ambiente personalizzato viene visualizzato sullo sfondo.

Ambienti fotografici panoramici a 360 gradi

L'emulatore supporta panorami equirettangolari standard in formato JPG o PNG. Le foto a 360 gradi ti consentono di testare le tue app per occhiali in uno sfondo più realistico, in cui il movimento e la rotazione della testa svolgono un ruolo nella valutazione degli elementi UI facilmente consultabili.

Per ruotare la visuale nell'ambiente, tieni premuto il tasto Shift mentre utilizzi il mouse o i tasti Freccia della tastiera.

Acquisisci uno screenshot

Per acquisire l'output visivo della tua app in esecuzione nell'emulatore, puoi scattare screenshot.

Per farlo, fai clic su Acquisisci screenshot nei controlli dell'emulatore.

Utilizza i controlli dell'emulatore per acquisire uno screenshot del display dell'emulatore in Android Studio.
 

Questa operazione funziona allo stesso modo dell'acquisizione di screenshot per altri dispositivi virtuali nell'emulatore Android XR e salva lo screenshot acquisito come file PNG.

Acquisisci una registrazione dello schermo

Per acquisire una registrazione dello schermo della tua app in esecuzione nell'emulatore:

  1. Fai clic su Registra schermo nei controlli dell'emulatore.

    Utilizza i controlli dell'emulatore per acquisire una registrazione dello schermo del display dell'emulatore in Android Studio.

  2. Seleziona "Mostra tocchi" se vuoi evidenziare le interazioni degli utenti.

  3. Dopo aver acquisito ciò che ti serve, fai clic su Interrompi registrazione.

    Viene visualizzata un'anteprima e puoi salvare il file sul computer.

Scattare foto o registrare video

Le funzionalità di acquisizione della fotocamera nell'emulatore Android XR non sono ancora disponibili.

Attiva il timeout della posticipazione del display

Per impostazione predefinita, il display dell'emulatore non si spegne durante lo sviluppo e il test dell'app. Tuttavia, il comportamento del timeout del display è importante quando progetti esperienze per occhiali con display reali. A causa dei rigidi vincoli termici e della batteria degli occhiali con display, devi ottimizzare il consumo energetico in modo che gli utenti possano interagire con i loro dispositivi il più a lungo possibile. Attiva il timeout di posticipo del display e testa la tua app in modo da poter osservare il comportamento reale del dispositivo e regolare l'app di conseguenza.

Per attivare il timeout del display, esegui il seguente comando ADB:

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

Per ripristinare il comportamento predefinito senza timeout, esegui questo comando ADB:

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