Un subespacio es una partición de espacio 3D dentro de tu app en la que puedes colocar modelos 3D, crear diseños 3D y agregar profundidad a contenido que, de otra forma, es 2D. Un subespacio solo se renderiza cuando la espacialización está habilitada. En el Espacio principal o en dispositivos que no son de RE, se ignora cualquier código dentro de ese subespacio.
Para obtener más información sobre los diseños espaciales y los componentes que puedes usar dentro de un subespacio, consulta Componentes espacializados.
Acerca de las jerarquías de subespacios
El Subspace de nivel superior es el subespacio más externo que invoca tu app.
Cada llamada a un método Subspace crea una jerarquía de IU espacial nueva e independiente. No hereda la posición espacial, la orientación ni la escala de ningún Subspace superior en el que esté anidado.
Para crear un Subspace incorporado o anidado dentro de un SpatialPanel, Orbiter,
SpatialPopup o cualquier otro componente, usa PlanarEmbeddedSubspace.
PlanarEmbeddedSubspace tiene dos diferencias clave con Subspace:
- Participan en el diseño en 2D en el que se invocan. Esto significa que la altura y el ancho del subespacio estarán limitados por la altura y el ancho de su diseño de nivel superior en 2D.
- Se comportan como elementos secundarios de la entidad en la que se invocan. Esto significa que,
si llamas a un elemento componible de subespacio anidado dentro de un
SpatialPanel, ese subespacio es un elemento secundario delSpatialPanelen el que se llama.
Estos comportamientos de PlanarEmbeddedSubspace habilitan funciones como las siguientes:
- Mover la entidad secundaria con la entidad principal
- Desplazar la ubicación del elemento secundario con el desplazamiento
SubspaceModifier - Presentar un objeto 3D que se desplace sobre tu IU 2D y que coincida con la altura y el ancho del espacio adecuado en el diseño 2D
Cómo adaptar los diseños para un subespacio
En Android XR, el diseño de tu app está vinculado al VolumeConstraints de Subspace en el modo de espacio completo de forma predeterminada. Por lo tanto, debes tener en cuenta la cantidad de espacio visible disponible para el usuario y ajustar el diseño según corresponda. El recommendedContentBoxInFullSpace proporciona las dimensiones específicas para el cuadro delimitador dentro del ActivitySpace, de modo que el contenido se pueda colocar dentro del campo visual del usuario.
El contenido principal de tu app debe caber en este cuadro. Si tienes contenido que debe superar los límites recomendados, considera un diseño que anime a los usuarios a explorar el espacio moviendo la cabeza. La restricción predeterminada de
recommendedContentBoxInFullSpace se puede anular aplicando un modificador personalizado
basado en el tamaño, como SubspaceModifier.requiredSizeIn. Para el comportamiento sin límites, establece allowUnboundedSubspace = true.
Llama a recommendedContentBoxInFullSpace con la Session actual para obtener estas dimensiones específicas según sea necesario. Consulta el siguiente ejemplo:
val session = LocalSession.current session?.scene?.activitySpace?.recommendedContentBoxInFullSpace
Agrega un subespacio a tu app
En el siguiente ejemplo de código, se muestra cómo agregar Subspace y PlanarEmbeddedSubspace a tu 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 {} } }
Consulta la documentación de referencia completa sobre Subspace y
PlanarEmbeddedSubspace para obtener más detalles.