Session

Session fournit l'interface principale aux fonctionnalités spatialisées de l'application. Chaque activité spatialisée doit créer et conserver une instance de Session. Une fois créée, l'application peut utiliser les interfaces Session pour créer des entités de contenu spatialisées 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 le contenu au monde réel.

Accéder à la session depuis Jetpack Compose for XR

Lorsque vous utilisez Jetpack Compose for 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 à la session à partir de Jetpack SceneCore

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

La création d'une session n'est possible que sur un appareil Android XR. Toute tentative de création d'une session sur un appareil incompatible échouera. 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

Lorsque l'activité d'une session est détruite, l'UI spatiale et le contenu 3D associés à cette session sont également détruits, et la session n'est plus valide.

Voir aussi