Questa documentazione ti guida nell'utilizzo dell'emulatore Android XR e di Layout Inspector in Android Studio per la creazione di un'app XR.
Android Studio include le seguenti nuove funzionalità per XR:
- Emulatore Android XR
- Supporto XR in Layout Inspector

Emulatore Android XR
L'emulatore Android XR fornisce un dispositivo XR virtualizzato per testare ed eseguire il debug delle tue app XR in Android Studio. Emula un dispositivo XR, consentendoti di provare la tua app in un ambiente spaziale 3D. In questo modo, puoi creare le tue app senza la necessità di hardware fisico durante le prime fasi di sviluppo, semplificando il flusso di lavoro e accelerando l'iterazione.
Se è la prima volta che utilizzi un emulatore con Android Studio, ti consigliamo di consultare la documentazione generale per l'emulatore Android.
Avvia l'emulatore Android XR
Dopo aver installato l'emulatore Android XR, fai clic sul pulsante Esegui in Device Manager sul dispositivo.

Attivare mouse e tastiera
Al momento, l'emulatore supporta solo l'input da mouse e tastiera. Quando utilizzi l'emulatore, assicurati che l'icona della tastiera e del mouse sia selezionata.

Una volta fatto, puoi iniziare a interagire con i vari elementi all'interno dello spazio virtuale spostando il mouse sulla finestra dell'emulatore.
Guardare e muoversi nell'ambiente virtuale
L'emulatore Android XR esegue il rendering degli elementi dell'applicazione in un ambiente 3D virtuale. Utilizza i seguenti controlli per modificare la direzione della visualizzazione, la panoramica, il movimento della telecamera, la rotazione e il ripristino:
|
Panoramica: fai clic e trascina il mouse per spostarti verso l'alto, il basso e lateralmente. In questo modo, potrai visualizzare i contenuti dell'emulatore da diverse angolazioni |
|
Dolly: fai clic e trascina il mouse per avvicinarti o allontanarti dagli oggetti in visualizzazione |
|
Ruota: fai clic e trascina il mouse per ruotare la visualizzazione in quella direzione |
|
Reimposta: fai clic su questo pulsante per ripristinare la visualizzazione predefinita dell'emulatore |
Puoi anche utilizzare le seguenti scorciatoie da tastiera per spostarti nell'ambiente virtuale. Per utilizzarli durante l'input da mouse e tastiera, tieni premuto il tasto Opzione (macOS) o il tasto Alt (Windows).
- W (o tasto Freccia su): sposta in avanti la visualizzazione corrente.
- A (o tasto Freccia sinistra): passo laterale a sinistra.
- S: (o tasto Freccia giù): sposta indietro.
- D (o tasto Freccia destra): passo laterale a destra.
- D: Sposta verticalmente verso il basso.
- E: Sposta verticalmente verso l'alto.
Abilitare la modalità passthrough
Utilizza la seguente opzione di menu per attivare o disattivare un ambiente passthrough simulato.

Se attivata, la modalità passthrough mostrerà un ambiente interno simulato. Utilizza questa modalità per testare le applicazioni in realtà mista.

Altri controlli dell'emulatore
|
Alimentazione: simula l'accensione o lo spegnimento del dispositivo |
|
Volume: simula il controllo del volume |
|
Screenshot: acquisisce uno screenshot dello stato attuale del dispositivo |
|
Controllo con tre pulsanti di Android: simula i pulsanti Indietro, Home e Panoramica |
Risoluzione dei problemi
Consulta le note di rilascio per eventuali problemi noti e soluzioni alternative.
Se riscontri un problema che non è un problema noto, consulta la pagina di assistenza per istruzioni su come ricevere aiuto e segnalare i problemi.
L'inclusione di un report sugli arresti anomali o di un report sui bug ci aiuterà a comprendere meglio il problema. Screenshot e registrazioni forniscono anche i dettagli aggiuntivi necessari. Le istruzioni riportate in questa sezione spiegano come caricare un report sugli arresti anomali e utilizzare adb per generare un report sui bug.
Utilizzare Layout Inspector di Android Studio con un'app XR
Dopo aver iniziato a creare i pannelli spaziali e gli orbiter, puoi esaminare il layout con Android Studio Layout Inspector. Se non hai familiarità con Layout Inspector, consulta la nostra guida al debug del layout.
Segui questi passaggi per utilizzare Layout Inspector con la tua app Android XR:
- Con il progetto aperto in Android Studio, assicurati che Layout
Inspector incorporato sia disattivato (deseleziona l'opzione e riavvia Android Studio).

- Esegui l'app.
- Una volta completato il deployment dell'applicazione, scegli Strumenti > Layout Inspector.
Layout Inspector si aprirà in una finestra incorporata. Dopo alcuni secondi, l'anteprima viene visualizzata a sinistra e l'albero dei componenti a destra. Gli orbiter e i riquadri vengono visualizzati come oggetti separati sotto i contenuti principali.

Ora puoi interagire con la tua app nell'emulatore. Se vuoi esaminare un componente, fai clic su di esso nell'anteprima o nell'albero dei componenti.
Puoi visualizzare gli attributi del componente facendo clic sulla scheda degli attributi nell'angolo a destra.

Attivare le statistiche sull'utilizzo per contribuire a migliorare Android Studio per XR
Valuta la possibilità di attivare le statistiche sull'utilizzo e di inviare feedback per aiutarci a migliorare questi strumenti. Poiché si tratta di una versione canary di Android Studio, molte di queste funzionalità sono ancora in fase di sviluppo.
Fai clic su Impostazioni > Aspetto e comportamento > Impostazioni di sistema > Condivisione dei dati e assicurati che l'opzione Invia statistiche di utilizzo a Google sia selezionata.

OpenXR™ e il logo OpenXR sono marchi di proprietà di The Khronos Group Inc. e sono registrati come marchi in Cina, nell'Unione Europea, in Giappone e nel Regno Unito.