Questa documentazione ti guida nell'utilizzo dell'emulatore Android XR e di Layout Inspector in Android Studio per creare un'app XR.
Android Studio include le seguenti funzionalità per XR:
- Emulatore Android XR
- Supporto XR in Layout Inspector
Emulatore Android XR
L'emulatore Android XR fornisce dispositivi XR virtualizzati per testare ed eseguire il debug delle tue app XR in Android Studio. Emula i dispositivi 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 per il dispositivo corrispondente in Device Manager.
Controlli dell'emulatore XR
Quando viene caricato l'emulatore Android XR, nota il menu nell'angolo in basso a destra. Questo menu ti consente di selezionare vari controlli per l'interazione con l'emulatore.
Attivare mouse e tastiera
L'emulatore supporta l'interazione tramite input mouse e tastiera. Quando interagisci con il sistema o con un'applicazione Android nell'emulatore, assicurati che l'icona di interazione 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 delle applicazioni e dei relativi contenuti in un ambiente 3D virtuale. Utilizza i seguenti controlli per modificare la direzione della visualizzazione, ruotare, spostare, avvicinare e ripristinare:
|
Ruota: trascina il mouse per ruotare la visualizzazione in quella direzione. |
|
Panoramica: trascina il mouse per spostarti verso l'alto, verso il basso e lateralmente. In questo modo, potrai visualizzare i contenuti dell'emulatore da diverse angolazioni |
|
Dolly: trascina il mouse per avvicinarti o allontanarti dagli oggetti in visualizzazione |
|
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): vai avanti nella 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
Il menu nella parte superiore dell'emulatore include l'opzione 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 o una registrazione dello schermo 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 abilitato.
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 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.