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 les appareils tels que les casques XR et les lunettes XR filaires, d'autres vous aident à améliorer les expériences augmentées pour les 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 d'ARCore pour Jetpack XR reposent sur un Session, qui
utilise Jetpack XR Runtime.
La manière dont votre application doit accéder à une session dépend des types d'expériences d'application que vous améliorez avec les fonctionnalités de perception :
- Si votre application améliore les expériences immersives avec une interface utilisateur spatiale à l'aide de Jetpack Compose for XR, accédez à une session à partir de Jetpack Compose for XR.
- Dans tous les autres cas, vous pouvez accéder à une session à partir de Jetpack XR Runtime, comme indiqué dans la section suivante de cette page.
Accéder à une session à partir de 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 create()
méthode, comme indiqué dans l'exemple suivant :
when (val result = Session.create(this)) { is SessionCreateSuccess -> { val xrSession = result.session // ... } else -> TODO(/* A different unhandled exception was thrown. */) }
Lorsque l'activité d'une 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
Certaines fonctionnalités peuvent être 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 dispose d'une session, découvrez comment l'utiliser pour améliorer les expériences d'application pour différents appareils XR :
- Détecter des plans à l'aide d'ARCore pour Jetpack XR
- Créer des points d'ancrage avec ARCore pour Jetpack XR
- Utiliser les mains avec ARCore pour Jetpack XR
- Intégrer la position de la tête dans votre application avec ARCore pour Jetpack XR
- Intégrer le suivi du visage dans votre application avec ARCore pour Jetpack XR
- Récupérer des informations de profondeur dans votre application avec ARCore pour Jetpack XR
- Suivre la pose d'un appareil à l'aide d'ARCore pour Jetpack XR