Accedere a una sessione per creare UI ed entità spazializzate

Dispositivi XR applicabili
Queste indicazioni ti aiutano a creare esperienze per questi tipi di dispositivi XR.
Scopri di più sui tipi di dispositivi XR →
Visori XR
Occhiali XR con cavo
Scopri di più sui tipi di dispositivi XR →

Session fornisce l'interfaccia principale per la funzionalità spazializzata della tua app. Ogni Activity spazializzato deve creare e contenere un'istanza di Session. Dopo aver creato una sessione, l'app può utilizzare le interfacce Session per creare entità di contenuti spazializzati come pannelli o modelli 3D, nonché per impostare un ambiente spaziale, identificare la posizione dell'utente e ancorare i contenuti al mondo reale.

Accedere a una sessione da Jetpack Compose per XR

Quando utilizzi Jetpack Compose per XR, la sessione viene creata automaticamente e puoi accedervi utilizzando LocalSession.current. Vedi il seguente esempio:

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

Accedere a una sessione da Jetpack XR Runtime

Se stai creando entità spazializzate dalla libreria Jetpack SceneCore, devi creare una sessione.

Per creare una sessione, passa un'attività al metodo create(), come mostrato nell'esempio seguente:

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

Quando l'attività di una sessione viene eliminata, vengono eliminati anche tutti i contenuti 3D e l'interfaccia utente spaziale associati a quella sessione e la sessione non è più valida.

Vedi anche