Acessar uma sessão para criar interfaces e entidades espacializadas

Dispositivos XR aplicáveis
Estas orientações ajudam você a criar experiências para esses tipos de dispositivos de XR.
Saiba mais sobre os tipos de dispositivos XR →
Headsets de realidade estendida
Óculos XR com fio
Saiba mais sobre os tipos de dispositivos XR →

O Session fornece a interface principal para a funcionalidade espacializada do seu app. Cada Activity espacializado precisa criar e manter uma instância de Session. Depois que o app cria uma sessão, ele pode usar as interfaces Session para criar entidades de conteúdo espacializado, como painéis ou modelos 3D, além de definir um ambiente espacial, identificar a posição do usuário e ancorar conteúdo no mundo real.

Acessar uma sessão do Jetpack Compose para XR

Ao usar o Jetpack Compose para XR, a sessão é criada para você e pode ser acessada usando LocalSession.current. Confira este exemplo:

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

Acessar uma sessão do Jetpack XR Runtime

Se você estiver criando entidades espacializadas da biblioteca Jetpack SceneCore, será necessário criar uma sessão.

Para criar uma sessão, transmita uma atividade ao método create(), conforme mostrado no exemplo a seguir:

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

Quando a atividade de uma sessão é destruída, toda a interface espacial e o conteúdo 3D associados a ela também são destruídos, e a sessão perde a validade.

Veja também