Accede a una sesión para crear entidades y una IU espacializadas

Dispositivos XR aplicables
Esta guía te ayuda a crear experiencias para estos tipos de dispositivos de XR.
Más información sobre los tipos de dispositivos XR →
Auriculares XR
Lentes de RE con cable
Más información sobre los tipos de dispositivos XR →

El Session proporciona la interfaz principal para la funcionalidad espacializada de tu app. Cada Activity espacializado debe crear y mantener una instancia de Session. Después de que tu app crea una sesión, puede usar las interfaces de Session para crear entidades de contenido espacializado, como paneles o modelos 3D, así como establecer un entorno espacial, identificar la posición del usuario y anclar contenido al mundo real.

Cómo acceder a una sesión desde Jetpack Compose para XR

Cuando usas Jetpack Compose para XR, la sesión se crea automáticamente y puedes acceder a ella con LocalSession.current. Observa el siguiente ejemplo:

@Composable
fun ComposableUsingSession() {
    val session = LocalSession.current
}
Session.kt

Cómo acceder a una sesión desde el entorno de ejecución de Jetpack XR

Si creas entidades espacializadas a partir de la biblioteca de Jetpack SceneCore, deberás crear una sesión.

Para crear una sesión, pasa una actividad al método create(), como se muestra en el siguiente ejemplo:

when (val result = Session.create(this)) {
    is SessionCreateSuccess -> {
        val xrSession = result.session
        // ...
    }
    else ->
        TODO(/* A different unhandled exception was thrown. */)
}
Session.kt

Cuando se destruye la actividad de una sesión, se destruyen toda la IU espacial y el contenido 3D asociados a esa sesión, y la sesión deja de ser válida.

Consulta también