Design para XR imersivo: Layout
Recursos e orientações para dispositivos XR imersivos
Em XR, um layout vai além da tela e adentra o mundo físico. Painéis espaciais, modelos 3D e um ambiente imersivo podem ser organizados em qualquer ponto de um espaço infinito.
Ao contrário dos layouts para dispositivos móveis, limitados pelas bordas da tela, os layouts XR devem considerar:
- Profundidade no eixo Z
- Distância de visualização
- O campo de visão do usuário
Mais sobre layouts do Android XR
Fundamentos de layout em XR
O elemento fundamental de um app Android XR é o painel espacial. Os painéis funcionam como contêineres para elementos de UI e podem ser elevados espacialmente ao lado de orbiters, modelos 3D e ambientes.
TIP
Os painéis espaciais estão disponíveis apenas no full space. No momento, não estão disponíveis no home space.
Painéis espaciais
No full space, os painéis espaciais são superfícies flexíveis que podem conter elementos de UI, conteúdo de mídia e vídeo espacial.
Com frequência, servem como âncora para modelos 3D e orbiters.
Tamanho e posição
O full space permite posicionar painéis tanto em ambientes com passthrough quanto em ambientes virtuais.
Por padrão, os painéis espaciais são exibidos com as seguintes configurações:
- Tamanho: 1024x720dp
- Distância do usuário: 1,75 metro
- Cantos arredondados: 32dp
No full space, os painéis não têm tamanho mínimo. O tamanho máximo é 2560x1800dp.
Ao alternar do full space para o home space, os painéis espaciais geralmente permanecem na mesma posição previsível.



Design adaptativo
Os painéis espaciais são redimensionados dinamicamente com base na distância até o usuário.
Os componentes do Material 3 usam design adaptativo para garantir que o conteúdo seja redimensionado e reorganizado automaticamente, mantendo a legibilidade e o conforto em qualquer distância ou ângulo.
Para evitar conflitos com a UI do sistema, mantenha os painéis dentro dos limites padrão de movimento:
- Profundidade mínima: 0,75 metro
- Profundidade máxima: 5 metros
Agrupamento de painéis
No full space, um app pode ser dividido em vários painéis espaciais organizados em um layout plano, curvo ou arbitrário.



Orbiters
Um orbiter é um elemento flutuante que acompanha um painel espacial.
Use orbiters para elementos de UI de navegação que precisam permanecer acessíveis sem obstruir o conteúdo principal.
Os componentes XR do Material se transformam automaticamente em orbiters.
Elevação espacial e profundidade
Use o eixo Z para criar UI volumétrica. Diferentemente da elevação 2D, que usa sombras, a UI volumétrica usa profundidade real.
- A elevação espacial pode criar hierarquia, trazendo os elementos ativos para frente e enviando os elementos de segundo plano para trás
- O uso de camadas pode separar fisicamente as camadas da UI. Por exemplo, um scrim pode flutuar vários centímetros atrás de um diálogo.
Comportamento
Ancoragem
No passthrough, os layouts podem interagir com o mundo físico:
- Ancoragem no mundo: Os painéis permanecem em um ponto específico do ambiente, como um tocador de música ancorado em uma mesa
- Ancoragem na cabeça: Evite fixar a UI diretamente à cabeça do usuário, pois isso pode parecer incômodo. Em vez disso, use um comportamento de acompanhamento suave com atraso, em que a UI desliza suavemente para acompanhar o movimento do usuário.
Contraste de cores e escurecimento
Ao usar os tokens padrão de surface, os painéis ajustam o contraste automaticamente:
- Passthrough: Quando o ambiente físico é claro, o sistema escurece o fundo para garantir que a UI permaneça legível
- Ambientes virtuais: Os painéis se adaptam à iluminação do mundo virtual