Un usuario puede experimentar tu app en dos modos: espacio principal o 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 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.
De forma predeterminada, la app se abre en el espacio principal, a menos que especifiques lo contrario, como se describe en la sección Declara el modo predeterminado para el inicio.
La espacialización solo se admite en el espacio completo. Tu app puede pasar al modo de espacio completo para aprovechar las funciones espaciales y en 3D. Cuando tu app tiene el foco, puedes alternar entre estos modos solicitando el espacio correspondiente.
Usa SpaceToggleButton para alternar entre el espacio principal y el espacio completo
Para realizar la transición entre el espacio principal y el espacio completo, usa el elemento componible SpaceToggleButton de la biblioteca de Material Design para XR.
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 XR, solicita el espacio principal o el espacio completo con la composición local LocalSession.
val session = LocalSession.current ?: return session.scene.requestHomeSpace() // or session.scene.requestFullSpace()
Si usas la biblioteca de SceneCore de Jetpack, puedes solicitar el espacio correspondiente desde Session. Consulta Cómo acceder a la sesión desde SceneCore de Jetpack.
xrSession.scene.requestHomeSpace()
Revisa 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.
Declara el modo predeterminado para el inicio
Como alternativa, puedes agregar las siguientes líneas al archivo de manifiesto de Android para elegir en qué espacio se debe abrir la 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
- Verifica las capacidades espaciales
- Crea una sesión
- Agrega entornos a tu app
- Agrega modelos 3D a tu app