Exécuter des applications Sceneform dans Android Emulator

Utilisez l'émulateur Android 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:

Configuration matérielle requise:

  • Pour pouvoir utiliser Sceneform dans votre application, vous aurez également besoin d'un ordinateur de développement compatible avec OpenGL ES 3.0 ou version ultérieure.

Télécharger les outils Android Studio et SDK pour ARCore

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

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

  3. Sélectionnez l'onglet SDK Platforms (Plates-formes du SDK), puis cochez la case Show Package Details (Afficher les détails du package).

    Sous Android 8.1 (Oreo), sélectionnez :
    API Google Intel x86 Atom System Image niveau 27, version 4 ou ultérieure.

  4. Sélectionnez l'onglet SDK Tools (Outils du SDK), puis ajoutez Android Emulator 27.2.9 ou une version ultérieure.

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

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

  7. Acceptez le contrat de licence pour le programme d'installation du composant.

  8. Cliquez sur Finish (Terminer).

Créer un appareil virtuel compatible avec la RA

Vous pouvez suivre les instructions d'Android Studio pour créer un appareil virtuel compatible avec la RA.

Configurer l'appareil virtuel

  • Sélectionnez le profil matériel Pixel ou Pixel 2.
  • Sélectionnez l'image système Oreo: API Level 27: x86: Android 8.1 (Google APIs).

  • Vérifiez que votre appareil virtuel est correctement configuré:

    • Consultez Vérifier la configuration &gt ; Afficher les paramètres avancés.
    • Assurez-vous que le champ Caméra arrière est défini sur VirtualScene (Scène virtuelle).

Configurer l'émulateur pour qu'il soit compatible avec Sceneform

Sceneform nécessite OpenGL ES 3.0 ou une version ultérieure.

  1. Assurez-vous que votre émulateur est configuré pour utiliser la dernière version d'OpenGL ES:

    • Cliquez sur More dans la barre d'outils de l'émulateur en cours d'exécution.
    • Sélectionnez Settings > Advanced > OpenGL ES API level > Renderer maximum (jusqu'à OpenGL ES 3.1).
    • Redémarrez l'émulateur. Lorsque vous y êtes invité, n'enregistrez pas l'état actuel.

  2. Après avoir redémarré l'émulateur, interagissez brièvement avec l'appareil émulé, puis vérifiez si OpenGL ES 3.0 ou version ultérieure est utilisé en récupérant les journaux de l'appareil:

    adb logcat | grep eglMakeCurrent

    Si vous voyez ver 3 0 ou une version ultérieure, vous pouvez exécuter des applications Sceneform dans l'émulateur : 

    … …  …  … D EGL_emulation: eglMakeCurrent: 0xebe63540: ver 3 0 (tinfo 0xd104cb40)

    Si vous voyez une version antérieure, cela signifie que votre GPU pour ordinateur n'est pas compatible avec OpenGL ES 3.0. Vous devez utiliser un appareil compatible physique pour exécuter les applications Sceneform.

Exécuter l'application

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

Mettre à jour Services Google Play pour la RA

La version des services Google Play pour la RA sur l'émulateur est probablement obsolète. Pour le modifier:

  1. Téléchargez la dernière version de Google_Play_Services_for_AR_1.15.0_x86_for_emulator.apk sur la page des versions de 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é sur l'émulateur en cours d'exécution ou installez-le à l'aide de adb pendant que l'appareil virtuel est en cours d'exécution :

    adb install -r Google_Play_Services_for_AR_1.15.0_x86_for_emulator.apk
    .

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

Contrôler la scène virtuelle

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

Déplacer la caméra virtuelle

Appuyez de manière prolongée sur Option (macOS) ou Alt (Linux ou Windows) pour accéder aux commandes de déplacement de la caméra. Utilisez les commandes suivantes pour déplacer la caméra:

Plate-forme Action Que devez-vous faire ?
Mac OS Déplacer le curseur vers la gauche ou la droite Maintenir la touche Option enfoncée, puis appuyer sur A ou D
Déplacer vers le bas ou vers le haut Maintenir la touche Option enfoncée, puis appuyer sur Q ou E
Avancer ou reculer Maintenir la touche Option enfoncée, puis appuyer sur W ou S
Modifier l'orientation de l'appareil Maintenir la touche Option enfoncée et déplacer la souris
Linux ou Windows Déplacer le curseur vers la gauche ou la droite Maintenir les touches Alt+A ou D enfoncées
Déplacer vers le bas ou vers le haut Maintenir les touches Alt+E ou E enfoncées
Avancer ou reculer Maintenir les touches Alt+S ou S enfoncées
Modifier l'orientation de l'appareil Maintenir les touches Alt+Déplacer la souris

Relâchez Option ou Alt pour revenir au mode interactif dans l'émulateur.

Utilisez l'onglet Capteurs virtuels sous Contrôles étendus pour positionner l'appareil avec plus de précision.

Conseils de dépannage

  • Si votre application ARCore s'affiche et qu'un message "AR Core non compatible" s'affiche, vérifiez la révision sur votre image système. Assurez-vous d'utiliser la révision 4 de l'API niveau 27.

  • Si votre application ARCore ne parvient pas à ouvrir la caméra au lancement, assurez-vous que l'option Caméra arrière est définie sur VirtualScene, comme décrit dans la procédure de configuration ci-dessus.