Le SDK Jetpack XR inclut tous les outils et bibliothèques dont vous avez besoin pour créer des expériences immersives et augmentées pour les appareils Android XR.
Créer des expériences entièrement immersives
Ciblez des appareils dédiés haute fidélité, tels que les casques XR et les lunettes XR filaires. Utilisez des outils de développement Android modernes tels que Kotlin et Compose, ainsi que des outils de génération précédente tels que Java et Views. Vous pouvez spatialiser votre UI, charger et afficher des modèles 3D, et comprendre sémantiquement le monde réel.
Si vous disposez déjà d'une application mobile ou pour grand écran sur Android, le SDK Jetpack XR donne une nouvelle dimension à votre application en spatialisant les mises en page existantes et en améliorant vos expériences avec des modèles 3D et des environnements immersifs. Consultez nos consignes relatives à la qualité pour obtenir des recommandations sur la spatialisation de votre application Android existante.
Créer des expériences augmentées et utiles
Ciblez des lunettes audio et des lunettes avec affichage légères et élégantes. Utilisez des outils pour les développeurs Android modernes tels que Kotlin et Jetpack Compose Glimmer. Utilisez des API qui facilitent les expériences d'application projetées d'un téléphone vers les lunettes.
Utiliser les bibliothèques Jetpack
Les bibliothèques du SDK Jetpack XR fournissent un kit d'outils complet pour créer des expériences immersives et riches, des expériences légères et augmentées et tout ce qui se trouve entre les deux. Les bibliothèques suivantes font partie du SDK Jetpack XR :
- Jetpack Compose pour XR : créez de manière déclarative des mises en page d'interface utilisateur spatiales qui exploitent les fonctionnalités spatiales d'Android XR.
- Material Design pour la XR : créez des composants et des mises en page Material qui s'adaptent à la XR.
- Jetpack SceneCore : créez et manipulez le graphe de scène Android XR avec du contenu 3D.
- ARCore pour Jetpack XR : intégrez du contenu numérique au monde réel grâce à des fonctionnalités de perception.
- Jetpack Compose Glimmer : kit d'UI permettant de créer des expériences Android XR augmentées, optimisées pour les lunettes avec affichage.
- Jetpack Projected : API qui facilitent les expériences dans l'application projetées d'un téléphone vers des lunettes audio ou des lunettes avec affichage.
Développement d'API pendant la phase de preview développeur
Les bibliothèques du SDK Jetpack XR font partie de la Preview développeur d'Android XR, et ces API sont encore en cours de développement. Consultez les notes de version de la bibliothèque pour connaître les problèmes connus :
- Notes de version de Jetpack Compose pour XR
- Notes de version d'ARCore pour Jetpack XR
- Notes de version de Jetpack SceneCore
- Notes de version de l'environnement d'exécution XR
- Notes de version de Jetpack Compose Glimmer
- Notes de version de Jetpack Projected
Si vous rencontrez un problème qui ne figure pas dans l'une de ces listes, veuillez signaler un bug ou envoyer des commentaires.
Jetpack Compose pour XR
Avec Jetpack Compose pour XR, vous pouvez utiliser des composants spatialisés tels que des lignes et des colonnes pour créer des interfaces utilisateur et des mises en page spatiales à l'aide d'un modèle Compose déclaratif familier.
Cette bibliothèque fournit également des composables de sous-espace, tels que des panneaux spatiaux et des orbiteurs, qui vous permettent de placer votre UI 2D existante basée sur Compose ou sur des vues dans une mise en page spatiale. D'autres composables de sous-espace gèrent d'autres types de cas d'utilisation spatiaux, comme SceneCoreEntity, qui vous permet de placer des entités telles que des modèles 3D par rapport à votre UI.
Vous pouvez utiliser Jetpack Compose pour XR, que vous souhaitiez spatialiser votre application Android existante ou créer une application XR de zéro.
Pour en savoir plus, consultez le guide du développeur pour l'UI spatiale et la documentation de référence de la bibliothèque et de l'API.
Material Design pour la XR
Material Design fournit des composants et des mises en page qui s'adaptent à la XR. Si vous utilisez des mises en page adaptatives. En savoir plus sur l'implémentation de Material Design pour la XR
Jetpack SceneCore
La bibliothèque Jetpack SceneCore vous permet de placer et d'organiser du contenu 3D, défini par des entités, les uns par rapport aux autres et par rapport à votre environnement. Avec SceneCore, vous pouvez :
- Définir des environnements spatiaux
- Créer des instances d'un
PanelEntity - Placer et animer des modèles 3D
- Spécifier des sources audio spatiales
- Ajouter des composants aux entités pour les rendre déplaçables, redimensionnables et ancrables dans le monde réel
La bibliothèque Jetpack SceneCore permet également de spatialiser les applications créées à l'aide de vues. Pour en savoir plus, consultez notre guide sur l'utilisation des vues.
Pour en savoir plus, consultez la documentation de référence de l'API.
ARCore pour Jetpack XR
Inspirée de la bibliothèque ARCore existante, la bibliothèque ARCore pour Jetpack XR offre des fonctionnalités permettant de fusionner du contenu numérique avec le monde réel. Cette bibliothèque inclut le suivi du mouvement, les ancres persistantes, les tests de positionnement et l'identification des plans avec étiquetage sémantique (par exemple, sol, murs et tables). Cette bibliothèque exploite la pile de perception sous-jacente optimisée par OpenXR, ce qui garantit la compatibilité avec un large éventail d'appareils et contribue à pérenniser les applications.
Pour en savoir plus, consultez Utiliser ARCore pour Jetpack XR.
Jetpack Compose Glimmer
Jetpack Compose Glimmer est un kit d'UI permettant de créer des expériences Android XR augmentées, optimisées pour les lunettes avec affichage. Créez une interface utilisateur esthétique, minimaliste et confortable pour les appareils portés toute la journée.
- Conçu pour être lisible et compréhensible d'un coup d'œil : contrairement aux téléphones, le canevas principal est un écran optique transparent. Jetpack Compose Glimmer fournit des thèmes spécifiques aux lunettes, des palettes de couleurs simplifiées et une typographie pour que votre contenu soit lisible, rapide à traiter et jamais distrayant.
- Optimisation pour les interactions spécifiques aux accessoires connectés : nous avons optimisé les modèles d'interaction en fonction de la façon dont les utilisateurs se servent de leurs lunettes. Les composants Jetpack Compose Glimmer proposent des états de sélection clairs, comme des contours optimisés au lieu d'effets d'ondulation distrayants, et sont conçus pour gérer les entrées physiques courantes comme les appuis, les balayages sur le cadre et, bien sûr, la voix.
- Utilisez des modèles d'UI déclaratifs familiers : comme Jetpack Compose Glimmer est entièrement basé sur Jetpack Compose, vous pouvez utiliser tout ce que vous savez déjà sur la création d'UI déclaratives dans Android. Nous fournissons un ensemble complet de fonctions composables de base prédéfinies, telles que Text, Icon, Button et des composants spécialisés comme TitleChip, tous optimisés pour l'environnement des lunettes.
Jetpack Projected
Lorsque vous développez pour des lunettes audio et des lunettes avec affichage, votre application s'exécute sur un appareil hôte associé, tel qu'un téléphone Android, qui projette les expériences XR de votre application. Jetpack Projected permet à ces appareils hôtes Android de communiquer avec des lunettes audio ou avec affichage si les appareils hôtes disposent de fonctionnalités de projection XR.
- Accéder au matériel de l'appareil projeté : contexte d'appareil lié à l'appareil projeté (lunettes audio ou lunettes avec affichage). Ce contexte projeté permet d'accéder au matériel de l'appareil projeté, comme l'appareil photo. Les activités dédiées créées spécifiquement pour s'afficher sur des lunettes audio ou avec affichage fonctionnent déjà comme un contexte projeté. Si une autre partie de votre application (comme une activité téléphonique ou un service) doit accéder au matériel des lunettes, elle peut obtenir un contexte projeté.
- Simplifier les demandes d'autorisation : les lunettes audio et les lunettes avec affichage suivent le modèle d'autorisation Android standard, avec des autorisations spécifiques aux lunettes qui doivent être demandées au moment de l'exécution avant que votre application puisse accéder au matériel de l'appareil, comme l'appareil photo. L'assistant d'autorisation simplifie ces mécanismes de demande d'autorisation sur les interfaces du téléphone et des lunettes pour offrir une expérience de demande cohérente.
- Vérifier les fonctionnalités de l'appareil et de l'écran : vérifiez si l'appareil projeté dispose d'un écran et l'état de l'écran pour présenter des éléments visuels. Adaptez votre application en fonction des capacités de l'appareil. Par exemple, vous pouvez fournir plus de contexte audio si l'appareil n'a pas d'écran ou si l'écran est éteint.
- Accéder aux actions de l'appareil photo de l'application : votre application peut accéder aux actions de l'appareil photo de l'utilisateur, par exemple pour activer ou désactiver l'appareil photo dans une application de streaming vidéo.
Tester les expériences d'application XR avec l'émulateur Android XR
L'émulateur Android XR est une version spécialisée d'Android Emulator conçue pour le développement d'applications XR. Il vous permet de tester et de déboguer vos applications XR dans l'environnement familier d'Android Studio. Créez des appareils virtuels pour n'importe quel type d'appareil Android XR, des appareils immersifs comme les casques XR et les lunettes XR filaires aux lunettes connectées comme les lunettes audio et les lunettes avec affichage.
Lorsque vous êtes prêt à exécuter et à déboguer votre application, consultez les guides suivants pour commencer :
- Créer des appareils virtuels pour les casques XR et les lunettes XR
- Créer des appareils virtuels pour les lunettes audio et les lunettes avec affichage
OpenXR™ et le logo OpenXR sont des marques appartenant à The Khronos Group Inc. et sont déposées en Chine, dans l'Union européenne, au Japon et au Royaume-Uni.