Accéder à une session pour créer des entités et une UI spatialisées

Appareils XR concernés
Ces conseils vous aident à créer des expériences pour ces types d'appareils XR.
En savoir plus sur les types d'appareils XR
Casques XR
Lunettes XR filaires
En savoir plus sur les types d'appareils XR

Session fournit l'interface principale aux fonctionnalités spatialisées de votre application. Chaque Activity spatialisé doit créer et conserver une instance de Session. Une fois que votre application a créé une session, elle peut utiliser les interfaces Session pour créer des entités de contenu spatialisé telles que des panneaux ou des modèles 3D, ainsi que pour définir un environnement spatial, identifier la position de l'utilisateur et ancrer du contenu dans le monde réel.

Accéder à une session depuis Jetpack Compose for XR

Lorsque vous utilisez Jetpack Compose pour XR, la session est créée pour vous et vous pouvez y accéder à l'aide de LocalSession.current. Consultez l'exemple suivant :

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

Accéder à une session depuis Jetpack XR Runtime

Si vous créez des entités spatialisées à partir de la bibliothèque Jetpack SceneCore, vous devez créer une session.

Pour créer une session, transmettez une activité à la méthode create(), comme illustré dans l'exemple suivant :

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

Lorsqu'une activité de session est détruite, tous les contenus 3D et l'UI spatiale associés à cette session sont détruits, et la session n'est plus valide.

Voir aussi