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 →

Le Session fournit l'interface principale aux fonctionnalités spatialisées de votre application. Chaque Activity spatialisé doit créer et contenir une instance de Session. Une fois qu'une session est créée, votre 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 définir un environnement spatial, identifier la position de l'utilisateur et ancrer le contenu dans le monde réel.

Accéder à une session à partir de 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
}

Accéder à une session à partir de 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 un [Context] à la create() méthode. Ce Context peut être un Activity sur des appareils XR immersifs ou appareils mobiles, ou un contexte projeté.

La création d'une session ARCore peut être une tâche coûteuse qui doit être traitée en arrière-plan, comme illustré dans l'exemple suivant :

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

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

Voir aussi