Transición del espacio principal al espacio completo

Un usuario puede experimentar tu app en dos modos: espacio principal o espacio completo. En el espacio principal, un usuario puede realizar varias tareas a la vez con tu app ejecutándose junto con otras apps. En el modo de espacio completo, tu app es la protagonista y el centro de la experiencia del usuario, con acceso completo a las capacidades inmersivas de Android XR.

Tu app se abre en el espacio principal de forma predeterminada, a menos que especifiques lo contrario, como se describe en la sección Cómo declarar el modo predeterminado de inicio.

La espacialización solo se admite en Full Space. Tu app puede hacer la transición a Full Space para aprovechar las capacidades espaciales y en 3D. Cuando tu app tiene el enfoque, puedes realizar la transición entre estos modos solicitando el espacio correspondiente.

Transición entre el espacio principal y el espacio completo

Si usas la biblioteca de Jetpack Compose para XR, solicita el espacio principal o el espacio completo con la composición local LocalSpatialConfiguration.

LocalSpatialConfiguration.current.requestHomeSpaceMode()
// or
LocalSpatialConfiguration.current.requestFullSpaceMode()
ModeTransition.kt

Si usas la biblioteca de Jetpack SceneCore, puedes solicitar el espacio correspondiente desde Session. Consulta Cómo acceder a la sesión desde Jetpack SceneCore.

xrSession.scene.requestHomeSpaceMode()
ModeTransition.kt

Consulta el codelab Descubre los aspectos básicos de Android XR: Parte 1 - Modos y paneles espaciales para ver ejemplos de cómo usar estas solicitudes para realizar la transición entre modos haciendo clic en un botón. También te recomendamos que revises nuestra guía de diseño para obtener más información sobre el modo de espacio principal a espacio completo y cómo realizar la mejor transición entre ambos.

Declara el modo predeterminado para el inicio

Como alternativa, puedes agregar las siguientes líneas a tu archivo de manifiesto de Android para elegir en qué espacio se debe abrir tu app:

<!-- Launch in Full Space. -->
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />

<!-- Or, launch in Home Space. -->
<property
   android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
   android:value="XR_ACTIVITY_START_MODE_HOME_SPACE_MANAGED" />

Consulta también