Exécuter les expériences immersives de votre application sur l'émulateur

Appareils XR concernés
Ces conseils vous aident à créer des expériences pour ces types d'appareils XR.
Casques XR
Lunettes XR filaires

Lorsque vous testez votre application, utilisez l'émulateur Android XR pour étendre votre capacité de test au-delà de vos appareils de test physiques. Vous pouvez utiliser les commandes de l'émulateur pour tester le comportement de votre application dans des scénarios courants avec des casques et des lunettes XR. Consultez les sections suivantes pour en savoir plus sur l'exécution de vos virtuels appareils Android XR dans l'émulateur et sur les commandes d'émulateur que vous pouvez utiliser.

Exécuter votre application sur l'émulateur

  1. Pour démarrer l'émulateur, cliquez sur Run (Exécuter) pour l'AVD dans le gestionnaire d'appareils.

    Écran du gestionnaire d'appareils Android Studio

    L'émulateur s'ouvre dans le panneau latéral.

    Écran de l'émulateur Android Studio

  2. Pour lancer votre application dans l'émulateur, cliquez sur Run (Exécuter) dans la barre d'outils principale d'Android Studio.

    Configuration de l'exécution d'une application Android Studio

Utiliser les commandes de l'émulateur pour les casques et les lunettes XR

Lorsque l'émulateur Android XR se charge, recherchez le menu semblable à celui illustré dans la figure 1. Utilisez les commandes de ce menu pour interagir avec l'émulateur.

Figure 1. Utilisez les commandes du menu de l'émulateur pour interagir avec l'émulateur.

Activer la souris et le clavier

L'émulateur est compatible avec l'interaction via une souris et un clavier. Lorsque vous souhaitez interagir avec le système ou une application Android dans l'émulateur, sélectionnez l'option de commandes d'interaction :

Icône de l'option d'interaction de l'émulateur Android XR

Après avoir sélectionné cette option, vous pouvez commencer à interagir avec les éléments de l'espace virtuel en déplaçant la souris sur la fenêtre de l'émulateur.

Regarder et se déplacer dans l'environnement virtuel

L'émulateur Android XR affiche les applications et leur contenu dans un environnement 3D virtuel. Utilisez les commandes suivantes pour modifier la direction de votre vue :

Icône de rotation Android Studio

Faire pivoter : faites glisser la souris pour faire pivoter votre vue dans cette direction.

Icône de déplacement dans Android Studio

Panoramique : faites glisser la souris pour vous déplacer de haut en bas et d'un côté à l'autre. Cela vous permet d'afficher le contenu de l'émulateur sous différents angles.

Icône de chariot Android Studio

Travelling : faites glisser la souris pour vous rapprocher ou vous éloigner des objets affichés.

Icône de réinitialisation d'Android Studio

Réinitialiser : cliquez sur ce bouton pour rétablir l'affichage 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 touche flèche vers le haut) : avancer dans la vue actuelle.
  • A (ou touche flèche vers la gauche) : se déplacer sur le côté gauche.
  • S (ou touche flèche vers le bas) : reculer.
  • D (ou touche flèche vers la droite) : se déplacer sur le côté droit.
  • Q : se déplacer verticalement vers le bas.
  • E : se déplacer verticalement vers le haut.

Activer le mode passthrough

Le menu en haut de l'émulateur inclut l'option "Toggle Passthrough" (Activer/Désactiver le passthrough) pour activer ou désactiver un environnement passthrough simulé.

Figure 2. Activez le passthrough pour afficher un environnement passthrough 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.

Figure 3. Un environnement passthrough simulé affiche des éléments d'interface utilisateur spatiaux ancrés dans une pièce.

Autres commandes de l'émulateur

Vous pouvez également utiliser les commandes d'émulateur suivantes :

Icône d'alimentation Android Studio

Power (Alimentation) : simule l'allumage ou l'extinction de l'appareil.

Icône Volume + dans Android Studio Icône Volume - d'Android Studio

Volume : simule le contrôle du volume.

Icône de capture d'écran Android Studio Icône d'enregistrement d'écran Android Studio

Capture d'écran : prend une capture d'écran ou enregistre l'écran de l'état actuel de l'appareil.

Icône Retour d'Android Studio Icône d'accueil Android Studio Icône de présentation d'Android Studio

Commandes à trois boutons Android : simule les boutons "Retour", "Accueil" et "Aperçu".