Exécuter des applications de RA dans Android Emulator

Utilisez Android Emulator pour tester des scénarios de RA sans appareil physique. Android Emulator vous permet d'exécuter des applications ARCore dans un environnement virtuel avec un appareil émulé que vous contrôlez.

Configurer l'environnement de développement

Configuration logicielle requise:

Obtenir Android Studio et SDK Tools pour ARCore

  1. Installez Android Studio 3.1 ou version ultérieure.

  2. Dans Android Studio, accédez à Preferences > Appearance and Behavior > System Settings > Android SDK.

  3. Sélectionnez l'onglet SDK Platforms, puis cochez Show Package Details.

    Sous la version d'Android appropriée, sélectionnez:
    API Google Intel x86 Atom System Image niveau d'API 27 ou supérieur

  4. Sélectionnez l'onglet SDK Tools et ajoutez Android Emulator 27.2.9 ou une version ultérieure.

  5. Cliquez sur OK pour installer les packages et outils sélectionnés.

  6. Cliquez de nouveau sur OK pour confirmer les modifications.

  7. Accept correspond au contrat de licence du programme d'installation du composant.

  8. Cliquez sur Finish.

Créer un appareil virtuel compatible avec la RA

Pour en savoir plus, consultez les instructions Android Studio pour créer un appareil virtuel.

Créer un appareil virtuel Android (AVD)

  1. Dans Android Studio, ouvrez le Gestionnaire d'appareils en cliquant sur Tools > Device Manager.

  2. Cliquez sur Create Device, en haut du panneau Gestionnaire d'appareils.

  3. Sélectionnez ou créez le profil matériel Phone (Téléphone) de votre choix, puis sélectionnez Next.

  4. Sélectionnez une image système x86 ou x86_64 exécutant le niveau d'API 27 ou une version ultérieure, puis sélectionnez Next.

    • Bien que les appareils ARCore physiques soient compatibles avec le niveau d'API 24 ou ultérieur, la prise en charge d'Android Emulator nécessite le niveau d'API 27 ou supérieur.

    • Seules les architectures Android Emulator basées sur x86 sont compatibles. Les autres architectures telles que arm64-v8a et armeabi-v7 ne sont pas compatibles actuellement.

  5. Vérifiez que votre appareil virtuel est correctement configuré:

    • Cliquez sur Show Advanced Settings.

    • Assurez-vous que Camera Back est défini sur VirtualScene.

  6. Cliquez sur Finish pour créer votre AVD.

Exécuter votre application

Testez une application ARCore sur un appareil virtuel compatible avec la RA dans l'émulateur. Pour ce faire, vous pouvez suivre les instructions d'Android Studio pour exécuter une application dans Android Emulator.

Mettre à jour les services Google Play pour la RA

La version des services Google Play pour la RA sur l'émulateur est probablement obsolète. Suivez ces instructions pour le mettre à jour:

  1. Téléchargez la dernière version de Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk sur la page des versions GitHub.

  2. Installez l'APK téléchargé dans chaque AVD que vous souhaitez utiliser:

    Démarrez l'AVD souhaité, puis faites glisser l'APK téléchargé depuis votre dossier système (par exemple, Downloads) sur l'émulateur en cours d'exécution ou installez-le à l'aide de adb lorsque l'appareil virtuel est en cours d'exécution :

    adb install -r Google_Play_Services_for_AR_1.41.0_x86_for_emulator.apk

Répétez ces étapes pour tous les AVD supplémentaires que vous souhaitez utiliser.

Contrôler la scène virtuelle

Lorsque votre application se connecte à ARCore, une superposition s'affiche expliquant comment contrôler la caméra et une barre d'état sous la fenêtre de l'émulateur.

Déplacer la caméra virtuelle

Appuyez de manière prolongée sur Shift pour accéder aux commandes de mouvement de la caméra. Utilisez les commandes suivantes pour déplacer la caméra:

Action Que faire ?
Déplacer vers la gauche ou la droite Maintenir la touche Maj enfoncée et appuyer sur A ou D
Déplacer vers le bas ou le haut Maintenir la touche Maj enfoncée et appuyer sur Q ou E
Avancer ou reculer Maintenir la touche Maj enfoncée et appuyer sur W ou S
Modifier l'orientation de l'appareil Maintenir la touche Maj enfoncée et déplacer la souris

Relâchez Shift pour revenir au mode interactif dans l'émulateur.

Utilisez l'onglet Virtual Sensors dans Commandes avancées pour un positionnement plus précis de l'appareil.

Ajouter des images augmentées à la scène

Chargez des images dans l'environnement simulé de l'émulateur pour tester les Augmented Images.

Utilisez l'onglet Camera dans Extended controls pour ajouter ou modifier des Scene images. Les images sont placées à deux emplacements : l'une sur le mur et l'autre sur la table.

Pour afficher les emplacements des images dans la scène, lancez votre émulateur, puis déplacez la caméra vers la salle à manger en passant par la porte située derrière la position de départ de la caméra.

Conseils de dépannage

  • Si votre application ARCore se lance et que le message "Cet appareil n'est pas compatible avec la RA" s'affiche, vérifiez la révision sur votre image système. Assurez-vous d'utiliser le niveau d'API 27 révision 4 ou version ultérieure.

  • Si votre application ARCore ne parvient pas à ouvrir l'appareil photo lorsqu'elle se lance, assurez-vous que Camera Back est défini sur VirtualScene, comme décrit dans les étapes de configuration ci-dessus.

  • Si votre application ARCore ne s'ouvre pas et que le message d'erreur "Failed to create AR session" (Échec de la création de session RA) s'affiche, consultez le journal de l'application. Si vous trouvez une java.lang.UnsatisfiedLinkError avec un message contenant /lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3), vous avez peut-être installé la mauvaise version de l'APK des services Google Play pour la RA. Créez un appareil virtuel et installez la version x86.