Seu app Android 2D para dispositivos móveis ou telas grandes funciona por padrão no Android XR, exibido como um painel 2D dentro do espaço 3D. Você pode adicionar recursos imersivos de XR para melhorar seu app Android 2D, transformando-o de uma experiência de tela plana em um ambiente 3D dinâmico.
Considere estes princípios importantes ao levar seu app Android para a XR.
- Recursos espaciais: o Android XR oferece uma ampla variedade de recursos espaciais para seu app, mas você não precisa implementar todos eles. Implemente estrategicamente as que complementam a hierarquia visual, os layouts e as jornadas do usuário do seu app. Considere incorporar ambientes personalizados e vários painéis para criar uma experiência verdadeiramente imersiva. Consulte as orientações de design de interface espacial para determinar a integração ideal de elementos espaciais.
- Interface adaptável: a XR oferece a flexibilidade de projetar uma interface espaçosa que se adapta perfeitamente a uma tela infinita e a janelas redimensionáveis. Uma das considerações mais importantes é usar nossas orientações de design para telas grandes para otimizar o layout do app para esse ambiente amplo. Mesmo que seu app seja apenas para dispositivos móveis, você ainda pode usar ambientes cativantes para melhorar a experiência do usuário, mas uma interface otimizada para telas grandes é uma das melhores maneiras de otimizar seu app para o Android XR.
- Framework de interface: recomendamos criar sua interface com o Jetpack Compose para XR. Se o app depende de visualizações, consulte Como trabalhar com visualizações em XR para saber mais sobre como aproveitar a interoperabilidade do Compose ao trabalhar com visualizações ou avalie trabalhar diretamente com a biblioteca SceneCore do Jetpack.
- Publicação no Google Play Store: para verificar se o app com XR é detectável no Google Play Store:
- Considere simplificar o app removendo todos os requisitos de recursos desnecessários.
- Verifique se o app não está desativado para publicação em XR no Google Play Console para evitar que ele seja excluído dos resultados da pesquisa da Play Store.
Converter componentes de interface 2D em 3D
Seguir essas dicas pode fazer uma grande diferença para que seu app pareça otimizado para XR.
- Priorize a compatibilidade com telas grandes: verifique se a interface do app segue os princípios de design para telas grandes para garantir a legibilidade ideal de textos e conteúdos em ambientes de XR amplos.
- Use recursos espaciais de forma estratégica: identifique momentos importantes na jornada do usuário do app em que a incorporação de recursos espaciais vai melhorar a experiência e aproveite os recursos exclusivos da plataforma.
- Posicione os painéis espaciais pensando no conforto do usuário: ao projetar seu layout com painéis espaciais, posicione-os a uma distância confortável do usuário para evitar que ele se sinta sobrecarregado ou muito próximo.
- Use uma interface adaptável para layouts espaciais: use conceitos de interface adaptável, como painéis e revelação progressiva, para decompor seu layout em vários painéis espaciais, otimizando a apresentação de informações.
- Use orbitadores para elementos e padrões persistentes: reserve orbitadores para elementos de UX persistentes e contextuais, como navegação e controles. Limite o uso de orbitadores para manter a clareza e evitar confusão.
- Use a elevação com cuidado: aplique a elevação espacial a componentes temporários que permanecem estacionários e não rolam com o conteúdo. Evite elevar áreas grandes para evitar desconforto visual e manter uma hierarquia visual equilibrada.
O Jetpack Compose para XR apresenta novos componentes que gerenciam as melhorias de XR para
que você não precise fazer isso. Por exemplo, é possível usar SpatialPopup e
SpatialDialog para substituir as contrapartes 2D. Esses componentes aparecem
como uma IU 2D típica quando a IU espacial não está disponível e mostram a IU espacial
do app quando podem. Usá-los é tão simples quanto fazer uma mudança de uma linha
para substituir o elemento da interface 2D correspondente.
Converter uma caixa de diálogo em SpatialDialog
// Previous approach Dialog( onDismissRequest = onDismissRequest ) { MyDialogContent() } // New XR differentiated approach SpatialDialog( onDismissRequest = onDismissRequest ) { MyDialogContent() }
Converter um pop-up em SpatialPopup
// Previous approach Popup(onDismissRequest = onDismissRequest) { MyPopupContent() } // New XR differentiated approach SpatialPopup(onDismissRequest = onDismissRequest) { MyPopupContent() }
Elevar elementos da interface 2D
Quando você quiser elevar a interface com um controle mais refinado, use
SpatialElevation para elevar qualquer elemento combinável no app a um nível
acima do painel espacial no eixo Z definido com SpatialElevationLevel.
Isso ajuda a chamar a atenção do usuário, cria uma hierarquia melhor e melhora
a legibilidade, como mostrado no exemplo a seguir.
// Elevate an otherwise 2D Composable (signified here by ComposableThatShouldElevateInXr). SpatialElevation(elevation = SpatialElevationLevel.Level4) { ComposableThatShouldElevateInXr() }
Pontos principais sobre o código
- Não espacializar ou elevar grandes áreas e planos, como páginas inferiores e laterais.
- Não eleve elementos da interface que são roláveis com o conteúdo.
Migrar componentes 2D para orbitadores
Os orbitadores são elementos flutuantes que geralmente contêm controles com os quais o usuário pode interagir. Os orbitadores podem ser ancorados em painéis espaciais ou outras entidades, como layouts espaciais. Eles permitem que o conteúdo tenha mais espaço e dão aos usuários acesso rápido aos recursos sem obstruir o conteúdo principal.

Coluna de navegação não espacializada

Coluna de navegação espacializada (adaptada para XR)
O código de exemplo a seguir mostra como migrar um componente de interface 2D para um orbiter.
// Previous approach NavigationRail() // New XR differentiated approach Orbiter( position = OrbiterPosition.TopStart( horizontalEdgeAlignment = OrbiterPosition.EdgeAlignment.Outside, offset = DpVolumeOffset(x = dimensionResource(R.dimen.start_orbiter_padding)) ) ) { NavigationRail() }
Pontos principais sobre orbitadores
- Os orbitadores são componentes projetados para anexar elementos da interface a um painel espacial
- Consulte nossas orientações de design de apps para Android XR para verificar quais elementos migrar para orbitadores e quais padrões evitar.
- Recomendamos adaptar apenas alguns componentes de navegação, como a coluna de navegação, a barra de apps de cima ou a barra de apps de baixo.
- Os orbitadores não aparecem quando a interface espacial não está ativada. Por exemplo, eles não vão aparecer no Espaço Compacto ou em dispositivos como smartphones, tablets e dobráveis.
Migrar componentes 2D para painéis espaciais
Os painéis espaciais são os elementos básicos da interface dos apps Android XR.
Os painéis servem como contêineres para elementos da interface, componentes interativos e conteúdo imersivo. Ao projetar, você pode adicionar componentes como orbitadores para controles do usuário e elevar espacialmente os elementos da interface para chamar a atenção para interações específicas.
Pontos principais sobre o código
- Consulte as orientações de design de apps Android XR para verificar quais elementos migrar para painéis e quais padrões evitar.
- Siga as práticas recomendadas para o posicionamento de painéis espaciais:
- Os painéis devem aparecer centralizados a 1,5 m dos olhos do usuário.
- O conteúdo precisa aparecer nos 41° centrais do campo de visão do usuário.
- Os painéis permanecem no lugar enquanto o usuário se move. A fixação só está disponível para passagem.
- Use os cantos arredondados de 32 dp recomendados pelo sistema para painéis.
- As áreas de toque precisam ter 56 dp e não podem ser menores que 48 dp.
- Mantenha as proporções de contraste para facilitar a leitura, especialmente se você usar planos de fundo transparentes.
- Siga os princípios de cores do design do Android e use o sistema de cores do Material Design para implementar temas escuros e claros no seu app.
- Use a API Spatial Panels com elementos de interface atuais.
Migrar a interface 2D para um único painel espacial
Por padrão, o app é mostrado com um único painel no Espaço Compacto. Saiba como
fazer a transição entre o Espaço Compacto e o Espaço Ampliado. Para levar esse conteúdo para o Espaço Ampliado, use SpatialPanel.
Veja um exemplo de como fazer isso.
if (LocalSpatialCapabilities.current.isSpatialUiEnabled) { Subspace { SpatialPanel( modifier = SubspaceModifier.movable().resizable(), ) { AppContent() } } } else { AppContent() }
Migrar a interface 2D para vários painéis espaciais
Você pode usar um único painel espacial para a interface do app ou migrar
sua interface 2D para vários painéis espaciais. Se você optar por usar vários painéis para
a interface do app, poderá posicionar e girar os painéis (semelhante ao layout da
interface em 2D). Comece com uma visão de design clara do que você quer
fazer e use as APIs de layout da interface espacial (SpatialBox,
SpatialRow, SpatialColumn, SpatialSpacer,
SpatialAlignment) e os modificadores de subespaço para posicionar e girar os painéis.
Há alguns padrões importantes que você deve evitar ao implementar vários
painéis.
- Evite sobrepor painéis que impeçam o usuário de ver informações importantes.
- Evite sobrecarregar o usuário com painéis.
- Evite colocar painéis em posições desconfortáveis ou imperceptíveis. Exemplo: painéis colocados atrás do usuário são difíceis de notar.
- Para saber mais sobre como desenvolver sua interface espacial, confira nossas orientações completas.

Conteúdo não espacializado

Controles de mídia espacializados (adaptados para XR) em um orbiter e conteúdo dividido em vários painéis espaciais
SpatialRow { SpatialPanel( SubspaceModifier .width(384.dp) .height(592.dp) ) { StartSupportingPanelContent() } SpatialPanel( SubspaceModifier .height(824.dp) .width(1400.dp) ) { App() } SpatialPanel( SubspaceModifier .width(288.dp) .height(480.dp) ) { EndSupportingPanelContent() } }
Adicionar recursos espaciais
Depois de conceituar e começar a converter seus componentes de interface 2D em 3D, você também pode começar a analisar outros recursos espaciais que podem ser adicionados ao app para criar uma experiência mais diferenciada para o Android XR.
Verificar recursos espaciais
Ao decidir se um elemento específico da interface será mostrado, evite verificar
dispositivos ou modos de XR específicos. Verificar dispositivos ou modos em vez de
recursos pode causar problemas quando os recursos de um determinado dispositivo mudam
com o tempo. Em vez disso, use
LocalSpatialCapabilities.current.isSpatialUiEnabled para verificar diretamente
os recursos de espacialização necessários, conforme mostrado no exemplo a seguir.
Essa abordagem garante que o app se adapte corretamente a uma ampla variedade de experiências
de XR sem precisar de atualizações sempre que novos dispositivos surgirem ou
as capacidades mudarem.
if (LocalSpatialCapabilities.current.isSpatialUiEnabled) { SupportingInfoPanel() } else { ButtonToPresentInfoModal() } // Similar check for audio val spatialAudioEnabled = LocalSpatialCapabilities.current.isSpatialAudioEnabled
Usar ambientes para mudar o entorno do usuário
Quando você quiser criar uma sensação de imersão no app mudando o ambiente do usuário, use os ambientes. Adicionar um ambiente no código é uma mudança simples que pode ser feita sem afetar significativamente a interface atual do app. Para saber mais sobre como configurar ambientes, confira nossas orientações completas.
Adicionar conteúdo 3D
O conteúdo 3D, como modelos 3D e vídeos espaciais, pode ajudar a criar uma experiência mais imersiva e adicionar compreensão espacial. Seu app só pode mostrar conteúdo 3D quando os recursos espaciais estão disponíveis. Por isso, verifique se eles estão disponíveis primeiro.
Consulte o guia apropriado para adicionar modelos 3D, vídeo espacial ou áudio espacial.