Transición del espacio principal al espacio completo

Un usuario puede experimentar tu app en dos modos: el modo de espacio principal o el modo de espacio completo. En el espacio principal, el 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 ocupa un lugar central como el foco de la experiencia del usuario con acceso completo a las funciones envolventes de Android XR.

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

La espacialización solo es compatible con Full Space. Tu app puede realizar la transición al espacio completo para aprovechar las funciones espaciales y en 3D. Cuando tu app tiene enfoque, puedes solicitar el espacio correspondiente para realizar la transición entre estos modos.

Transición entre el espacio principal y el espacio completo

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

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

Si usas la biblioteca de SceneCore de Jetpack, puedes solicitar el espacio correspondiente desde Session.

val xrSession = Session.create(this)
xrSession.spatialEnvironment.requestHomeSpaceMode()

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 espacio principal y el espacio completo, y cómo realizar la mejor transición entre ambos.

Cómo declarar 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_MANAGED" />

Consulta también