O Jetpack Compose para XR inclui uma variedade de componentes espacializados para ajudar você a criar layouts e interfaces espaciais para seu app.
Elementos combináveis do Subspace
Os subespaços de composição são um tipo especial de componentes espacializados que só podem
ser renderizados em um subespaço e precisam ser incluídos em Subspace
antes de serem colocados em um layout 2D. Um SubspaceModifier permite adicionar
atributos como profundidade, deslocamento e posicionamento aos elementos de composição
do subespaço.
Outros componentes espacializados
Outros componentes espacializados não precisam ser chamados dentro de um subespaço. Eles consistem em elementos 2D convencionais envolvidos em um contêiner espacial. Esses elementos podem ser usados em layouts 2D ou 3D, se definidos para ambos. Quando a espacialização não estiver ativada, os recursos espacializados serão ignorados e serão substituídos pelos equivalentes em 2D.
Os componentes espacializados podem ser colocados em qualquer lugar na hierarquia da interface do app. Esses elementos podem ser reutilizados na interface 2D, e os atributos espaciais deles só ficam visíveis quando os recursos espaciais estão ativados. Isso permite adicionar elevação a menus, caixas de diálogo e outros componentes sem precisar escrever o código duas vezes. Confira alguns exemplos de como diferentes componentes espacializados mudam o comportamento quando a espacialização está ativada ou não:
Componente espacializado |
Quando a espacialização está ativada |
Em um ambiente 2D |
|---|---|---|
|
O painel é empurrado um pouco para trás na profundidade Z para mostrar uma caixa de diálogo elevada |
Volta para 2D |
|
O painel é empurrado ligeiramente para trás na profundidade Z para mostrar um pop-up elevado |
Retorna para um |
|
|
Mostra sem elevação espacial. |
Guias
Esta seção inclui os seguintes guias para desenvolvedores: