Um subespaço é uma partição do espaço 3D no seu app em que você pode inserir modelos 3D, criar layouts 3D e adicionar profundidade ao conteúdo 2D. Um subespaço é renderizado somente quando a espacialização está ativada. No Home Space ou em dispositivos que não são XR, qualquer código dentro desse subespaço é ignorado.
Para mais informações sobre layouts espaciais e os componentes que podem ser usados em um subespaço, consulte componentes espacializados.
Sobre hierarquias de subespaço
O Subspace de nível superior é o subespaço mais externo invocado pelo app.
Cada chamada para um método Subspace cria uma nova hierarquia de interface espacial
independente. Ele não herda a posição espacial, a orientação ou a escala de nenhum
Subspace pai em que está aninhado.
Para criar um Subspace incorporado ou aninhado em um SpatialPanel, Orbiter,
SpatialPopup ou outro componente, use PlanarEmbeddedSubspace.
O PlanarEmbeddedSubspace tem duas diferenças principais em relação ao Subspace:
- Eles participam do layout 2D em que são invocados. Isso significa que a altura e a largura do subespaço serão limitadas pela altura e pela largura do layout pai 2D.
- Eles se comportam como filhos da entidade em que são invocados. Isso significa que,
se você chamar um elemento combinável de subespaço aninhado em um
SpatialPanel, esse subespaço será um filho doSpatialPanelem que é chamado.
Esses comportamentos de PlanarEmbeddedSubspace permitem recursos como:
- Mover o filho com a entidade pai
- Deslocamento do local do filho usando o deslocamento
SubspaceModifier - Apresentar um objeto 3D que flutua acima da interface 2D e corresponde à altura e à largura do espaço apropriado no layout 2D.
Adaptar layouts para um subespaço
No Android XR, o layout do app é vinculado ao VolumeConstraints de
Subspace no Modo de Espaço Ampliado por padrão. Por isso, considere
a quantidade de espaço visível disponível para o usuário e ajuste o
layout de acordo. O recommendedContentBoxInFullSpace fornece as
dimensões específicas para a caixa delimitadora dentro do ActivitySpace para que
o conteúdo possa ser colocado no campo de visão do usuário.
O conteúdo principal do app precisa caber nessa caixa. Se você tiver conteúdo que
precisa exceder os limites recomendados, considere um layout que incentive os usuários a
explorar o espaço movendo a cabeça. A restrição padrão do
recommendedContentBoxInFullSpace pode ser substituída aplicando um modificador
personalizado com base no tamanho, como SubspaceModifier.requiredSizeIn. Para comportamento ilimitado, defina allowUnboundedSubspace = true.
Chame recommendedContentBoxInFullSpace usando a Session atual para
receber essas dimensões específicas conforme necessário. Confira este exemplo:
val session = LocalSession.current session?.scene?.activitySpace?.recommendedContentBoxInFullSpace
Adicionar um subespaço ao app
O exemplo de código abaixo mostra como adicionar Subspace e
PlanarEmbeddedSubspace ao app:
setContent { // This is a top-level subspace Subspace { SpatialPanel { MyComposable() } } }
@Composable private fun MyComposable() { Row { PrimaryPane() SecondaryPane() } } @Composable private fun PrimaryPane() { // This is an embedded subspace, because PrimaryPane is in a SpatialPanel // and that SpatialPanel is in the top-level Subspace PlanarEmbeddedSubspace { SpatialPanel {} } }
Consulte a documentação de referência completa sobre Subspace e
PlanarEmbeddedSubspace para mais detalhes.