Cette documentation vous explique comment utiliser l'émulateur Android XR et l'outil d'inspection de la mise en page dans Android Studio pour créer une application XR.
Android Studio inclut les nouvelles fonctionnalités suivantes pour la réalité XR:
- Android XR Emulator
- Compatibilité avec la réalité XR dans l'outil d'inspection de la mise en page
Android XR Emulator
L'émulateur Android XR fournit un appareil XR virtualisé pour tester et déboguer vos applications XR dans Android Studio. Il émule un appareil XR, ce qui vous permet de découvrir votre application dans un environnement spatial 3D. Vous pouvez ainsi créer vos applications sans matériel physique lors des premières étapes de développement, ce qui simplifie votre workflow et accélère les itérations.
Si vous utilisez un émulateur avec Android Studio pour la première fois, consultez la documentation générale sur l'émulateur Android.
Lancer Android XR Emulator
Après avoir installé Android XR Emulator, cliquez sur le bouton Run (Exécuter) dans le gestionnaire d'appareils de l'appareil.
Activer la souris et le clavier
Actuellement, l'émulateur n'est compatible qu'avec la saisie au clavier et à la souris. Lorsque vous utilisez l'émulateur, assurez-vous que l'icône du clavier et de la souris est sélectionnée.
Une fois cette opération effectuée, vous pouvez commencer à interagir avec divers éléments de l'espace virtuel en déplaçant la souris sur la fenêtre de l'émulateur.
Parcourir l'environnement virtuel et s'y déplacer
L'émulateur Android XR effectue le rendu des éléments d'application dans un environnement 3D virtuel. Utilisez les commandes suivantes pour modifier la direction de votre vue, panoramiquer, faire un travelling, faire pivoter et réinitialiser:
|
Panoramique: cliquez et faites glisser la souris pour vous déplacer vers le haut, le bas et les côtés. Vous pourrez ainsi voir le contenu de l'émulateur sous différents angles. |
|
Dolly: cliquez et faites glisser la souris pour vous rapprocher ou vous éloigner des objets à l'écran. |
|
Rotation: cliquez et faites glisser la souris pour faire pivoter la vue dans cette direction. |
|
Réinitialiser: cliquez sur ce bouton pour rétablir la vue par défaut de l'émulateur. |
Vous pouvez également utiliser les raccourcis clavier suivants pour vous déplacer dans l'environnement virtuel. Pour les utiliser lorsque vous utilisez la souris et le clavier, maintenez la touche Option (macOS) ou Alt (Windows) enfoncée.
- W (ou flèche vers le haut): avancez dans la vue actuelle.
- A (ou touche fléchée vers la gauche): effectuer un pas latéral vers la gauche.
- S (ou flèche vers le bas) : reculez.
- D (ou flèche vers la droite): faites un pas latéral vers la droite.
- Q: Déplacer verticalement vers le bas
- E: Déplacer l'élément verticalement vers le haut.
Activer le mode passthrough
Utilisez l'option de menu suivante pour activer ou désactiver un environnement de transfert simulé.
Lorsqu'il est activé, le mode passthrough affiche un environnement intérieur simulé. Utilisez ce mode pour tester des applications en réalité mixte.
Autres commandes de l'émulateur
|
Alimentation: simule l'allumage ou l'extinction de l'appareil |
|
Volume: simule le contrôle du volume |
|
Capture d'écran: permet de prendre une capture d'écran de l'état actuel de l'appareil. |
|
Commande à trois boutons Android: simule les boutons "Retour", "Accueil" et "Aperçu" |
Dépannage
Consultez les notes de version pour connaître les problèmes connus et les solutions de contournement.
Si vous rencontrez un problème qui n'est pas un problème connu, consultez la page d'assistance pour obtenir des instructions sur l'obtention d'aide et le signalement de problèmes.
Incluez un rapport d'erreur ou de plantage pour nous aider à mieux comprendre le problème. Les captures d'écran et les enregistrements fournissent également des informations supplémentaires nécessaires. Les instructions de cette section expliquent comment importer un rapport d'erreur et utiliser adb pour générer un rapport de bug.
Utiliser l'outil d'inspection de la mise en page Android Studio avec une application XR
Une fois que vous avez commencé à créer vos panneaux spatiaux et vos orbiteurs, vous pouvez inspecter votre mise en page avec l'outil d'inspection de la mise en page d'Android Studio. Si vous ne connaissez pas l'outil d'inspection de la mise en page, consultez notre guide sur le débogage de la mise en page.
Pour utiliser l'outil d'inspection de la mise en page avec votre application Android XR:
- Une fois votre projet ouvert dans Android Studio, assurez-vous que l'inspecteur de mise en page intégré est désactivé (désactivez l'option et redémarrez Android Studio).
- Exécutez votre application.
- Une fois le déploiement de l'application terminé, sélectionnez Tools > Layout Inspector (Outils > Outil d'inspection de la mise en page).
Cet outil s'ouvre dans une fenêtre intégrée. Après quelques secondes, l'aperçu s'affiche à gauche et l'arborescence des composants à droite. Les orbiteurs et les panneaux apparaissent comme des objets distincts sous le contenu principal.
Vous pouvez maintenant interagir avec votre application dans l'émulateur. Si vous souhaitez inspecter un composant, cliquez dessus dans l'aperçu ou dans l'arborescence des composants.
Pour afficher les attributs du composant, cliquez sur l'onglet "Attributs" en haut à droite.
Activer les statistiques d'utilisation pour améliorer Android Studio pour XR
Pensez à activer les statistiques d'utilisation et à nous envoyer vos commentaires pour nous aider à améliorer ces outils. Comme il s'agit d'une version Canary d'Android Studio, de nombreuses fonctionnalités sont encore en cours de développement.
Cliquez sur Settings > Appearance & Behavior > System Settings > Data Sharing (Paramètres > Apparence et comportement > Paramètres système > Partage des données), puis assurez-vous que l'option Send usage statistics to google (Envoyer des statistiques d'utilisation à Google) est sélectionnée.
