Transición del espacio principal al espacio completo

Dispositivos de realidad extendida correspondientes
Esta guía te ayuda a crear experiencias para estos tipos de dispositivos de realidad extendida.
Más información sobre los tipos de dispositivos de realidad extendida →
Visores de realidad extendida
Lentes de realidad extendida con cable
Más información sobre los tipos de dispositivos de realidad extendida →

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 espacio completo, tu app ocupa un lugar central como el enfoque de la experiencia del usuario con acceso completo a las capacidades envolventes 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 Declara el modo predeterminado para el inicio.

La espacialización solo es compatible con el espacio completo. Tu app puede hacer la transición al espacio completo para aprovechar las capacidades espaciales y 3D. Cuando tu app tiene el enfoque, puedes hacer la transición entre estos modos solicitando el espacio correspondiente.

Usa SpaceToggleButton para cambiar entre el espacio principal y el espacio completo

Para hacer la transición entre el espacio principal y el espacio completo, usa el SpaceToggleButton elemento componible de la biblioteca de Material Design para realidad extendida.

Este es un botón componible que se adapta al modo espacial actual y alterna entre el espacio completo y el espacio principal.

Crea una transición personalizada entre el espacio principal y el espacio completo

Si usas la biblioteca de Jetpack Compose para realidad extendida, solicita el espacio principal o el espacio completo con el LocalSession elemento local de composición.

val session = LocalSession.current ?: return
session.scene.requestHomeSpace()
// or
session.scene.requestFullSpace()

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.requestHomeSpace()

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 hacer 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 espacio principal al espacio completo y cómo hacer la transición entre ambos de la mejor manera.

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 debe abrirse 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" />

Consulta también