Strumenti Android Studio per XR

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

Schermata dell'emulatore Android Studio

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.

Schermata di Gestione dispositivi di Android Studio

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.

Icona del mouse e della tastiera del dispositivo Android Studio

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:

Icona di panoramica di Android Studio

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

Icona del carrello di Android Studio

Dolly: fai clic e trascina il mouse per avvicinarti o allontanarti dagli oggetti in visualizzazione

Icona di rotazione di Android Studio

Ruota: fai clic e trascina il mouse per ruotare la visualizzazione in quella direzione

Icona di ripristino di Android Studio

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.

UI della modalità passthrough di Android Studio

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

Schermata dell'emulatore Android Studio

Altri controlli dell'emulatore

Icona di accensione di Android Studio

Alimentazione: simula l'accensione o lo spegnimento del dispositivo

Icona per alzare il volume di Android Studio Icona per abbassare il volume di Android Studio

Volume: simula il controllo del volume

Icona dello screenshot di Android Studio

Screenshot: acquisisce uno screenshot dello stato attuale del dispositivo

Icona Indietro di Android Studio Icona Home di Android Studio Icona di panoramica di Android Studio

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:

  1. Con il progetto aperto in Android Studio, assicurati che Layout Inspector incorporato sia disattivato (deseleziona l'opzione e riavvia Android Studio). Pagina delle impostazioni di Android Studio
  2. Esegui l'app.
  3. 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.

Pagina di Layout Inspector di Android Studio

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.

Pagina di Layout Inspector di Android Studio

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.

Pagina delle impostazioni di Android Studio


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.