Componenti spazializzati

Dispositivi XR applicabili
Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.
Visori XR
Occhiali XR con cavo

Jetpack Compose per XR include una serie di componenti spazializzati per aiutarti a creare UI e layout spaziali per la tua app.

Composable di Subspace

I componibili di sottospazio sono un tipo speciale di componenti spazializzati che possono essere visualizzati solo in un sottospazio e devono essere racchiusi in Subspace prima di essere inseriti in un layout 2D. Un SubspaceModifier ti consente di aggiungere attributi come profondità, offset e posizionamento ai tuoi elementi componibili dello spazio secondario.

Altri componenti spazializzati

Altri componenti spazializzati non richiedono di essere chiamati all'interno di un sottospazio. Sono costituiti da elementi 2D convenzionali racchiusi in un contenitore spaziale. Questi elementi possono essere utilizzati all'interno di layout 2D o 3D se definiti per entrambi. Quando la spazializzazione non è attiva, le funzionalità spazializzate vengono ignorate e vengono utilizzate le controparti 2D.

I componenti spazializzati possono essere posizionati in qualsiasi punto della gerarchia della UI dell'app. Questi elementi possono essere riutilizzati nella UI 2D e i loro attributi spaziali sono visibili solo quando le funzionalità spaziali sono attive. In questo modo puoi aggiungere l'elevazione a menu, finestre di dialogo e altri componenti senza dover scrivere il codice due volte. Ecco alcuni esempi di come i diversi componenti spazializzati cambiano il loro comportamento quando la spazializzazione è attivata o meno:

Componente spazializzato

Quando la spazializzazione è attiva

In un ambiente 2D

SpatialDialog

Il pannello si sposta leggermente indietro lungo l'asse Z per visualizzare una finestra di dialogo in rilievo

Torna alla modalità 2D Dialog.

SpatialPopup

Il riquadro si sposta leggermente indietro lungo l'asse Z per visualizzare un popup in rilievo

Torna a un Popup 2D.

SpatialElevation

SpatialElevationLevel può essere impostato per aggiungere l'elevazione.

Mostra senza elevazione spaziale.

Guide

Questa sezione include le seguenti guide per gli sviluppatori: