Améliorer les expériences d'application avec la perception à l'aide d'ARCore pour Jetpack XR

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
Lunettes IA
En savoir plus sur les types d'appareils XR

ARCore pour Jetpack XR offre de puissantes capacités de perception à votre application pour comprendre le monde réel grâce à diverses API. Certaines de ces API vous aident à améliorer les expériences immersives pour des appareils tels que les casques XR et les lunettes XR filaires, d'autres vous aident à améliorer les expériences augmentées pour des appareils tels que les lunettes d'IA, et d'autres encore vous aident à améliorer les expériences d'application pour tous les types d'appareils Android XR.

Par exemple, vous pouvez utiliser ARCore pour Jetpack XR afin de récupérer des données planaires, d'ancrer du contenu à un emplacement fixe dans l'espace ou d'utiliser une pose géospatiale pour ancrer du contenu à un emplacement réel.

Ajouter des dépendances de bibliothèque

Avant de commencer à utiliser les fonctionnalités de perception dans votre application XR, ajoutez les dépendances nécessaires, en fonction du type d'expériences d'application que vous améliorez avec la RA.

Accéder à une session

Les fonctionnalités de perception dans ARCore pour Jetpack XR s'appuient sur un Session, qui utilise le runtime Jetpack XR.

La façon dont votre application doit accéder à une session dépend des types d'expériences d'application que vous améliorez avec des fonctionnalités de perception :

Accéder à une session depuis Jetpack XR Runtime

Pour accéder à une session à partir de Jetpack XR Runtime, vous devez la créer :

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, tout le contenu de RA associé à cette session est détruit et la session n'est plus valide.

Configurer une session

Il est possible que certaines fonctionnalités soient désactivées par défaut et doivent être configurées pour fonctionner. Pour configurer une session, utilisez configure() et spécifiez les options de configuration dont votre Session a besoin. Pour en savoir plus sur la configuration requise pour les différentes fonctionnalités de RA, consultez les pages correspondantes pour chaque fonctionnalité de RA.

Étapes suivantes

Une fois que votre application a une session, découvrez comment l'utiliser pour améliorer l'expérience de l'application pour différents appareils XR :