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 :
Android Studio 3.1 ou version ultérieure.
Android Emulator 27.2.9 ou version ultérieure.
Obtenir Android Studio et les outils SDK pour ARCore
Installez Android Studio 3.1 ou version ultérieure.
Dans Android Studio, accédez à Preferences > Appearance and Behavior > System Settings > Android SDK.
Sélectionnez l'onglet SDK Platforms, puis cochez Show Package Details.
Sous la version Android appropriée, sélectionnez :
Image système Google APIs Intel x86 Atom (niveau d'API 27 ou version ultérieure).Sélectionnez l'onglet SDK Tools et ajoutez Android Emulator 27.2.9 ou version ultérieure.
Cliquez sur OK pour installer les packages et outils sélectionnés.
Cliquez de nouveau sur OK pour confirmer les modifications.
Accept le contrat de licence du programme d'installation de composants.
Cliquez sur Finish.
Créer un appareil virtuel compatible avec la RA
Pour en savoir plus, consultez les instructions d'Android Studio pour créer un appareil virtuel.
Créer un appareil virtuel Android (AVD)
Dans Android Studio, ouvrez le Gestionnaire d'appareils en cliquant sur Tools > Device Manager.
Cliquez sur Create Device en haut du panneau Gestionnaire d'appareils.
Sélectionnez ou créez le profil matériel Téléphone de votre choix, puis sélectionnez Next.
Sélectionnez une image système
x86oux86_64exécutant le niveau d'API 27 ou version ultérieure, puis sélectionnez Next.Les appareils ARCore physiques sont compatibles avec le niveau d'API 24 ou version ultérieure, tandis que l'Android Emulator nécessite le niveau d'API 27 ou version ultérieure.
Seules les architectures d'émulateur Android basées sur x86 sont prises en charge. Les autres architectures, telles que
arm64-v8aetarmeabi-v7, ne sont actuellement pas prises en charge.
Vérifiez que votre appareil virtuel est correctement configuré :
Cliquez sur Show Advanced Settings.
Assurez-vous que Camera Back est défini sur VirtualScene.
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
Il est probable que la version des services Google Play pour la RA sur l'émulateur soit obsolète. Pour le modifier, procédez comme suit :
Téléchargez la dernière version de Google_Play_Services_for_AR_1.50.0_x86_for_emulator.apk depuis la page Releases (Versions) de GitHub.
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 le dossier système (par exemple, Downloads) sur l'émulateur en cours d'exécution, ou installez-le à l'aide de
adbpendant que l'appareil virtuel est en cours d'exécution :adb install -r Google_Play_Services_for_AR_1.50.0_x86_for_emulator.apk
Répétez ces étapes pour chaque AVD supplémentaire que vous souhaitez utiliser.
Contrôler la scène virtuelle
Lorsque votre application se connecte à ARCore, une superposition s'affiche pour vous expliquer comment contrôler la caméra, ainsi qu'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 devez-vous faire ? |
|---|---|
| Déplacer vers la gauche ou la droite | Maintenez la touche Maj enfoncée et appuyez sur A ou D. |
| Déplacer vers le bas ou vers le haut | Maintenir la touche Maj enfoncée et appuyer sur Q ou E |
| Avancer ou reculer | Maintenez la touche Maj enfoncée et appuyez sur W ou S. |
| Modifier l'orientation de l'appareil | Appuyez sur Maj et déplacez la souris. |
Relâchez Shift pour revenir au mode interactif dans l'émulateur.
Utilisez l'onglet Virtual Sensors dans Commandes avancées pour positionner l'appareil plus précisément.
Ajouter des images augmentées à la scène
Chargez des images dans l'environnement simulé de l'émulateur pour tester Images augmentées.
Utilisez l'onglet Camera dans Extended controls pour ajouter ou modifier Scene images. Il y a deux emplacements pour les images : un sur le mur et un sur la table.
Pour afficher ces emplacements d'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 de 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 au lancement, 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 affiche le message d'erreur "Échec de la création de la session AR", consultez le journal de l'application. Si vous rencontrez un
java.lang.UnsatisfiedLinkErroravec un message contenant/lib/arm/libarcore_c.so" is for EM_ARM (40) instead of EM_386 (3), il est possible que vous ayez installé la mauvaise version de l'APK Services Google Play pour la RA. Créez un appareil virtuel et installez la version x86.