Guide de démarrage rapide pour Android

Pour commencer à utiliser ARCore avec Android, vous pouvez exécuter l'application exemple hello_ar_kotlin ou hello_ar_java incluse dans le SDK ARCore. Ces exemples d'applications utilisent OpenGL, une interface de programmation permettant d'afficher des graphiques vectoriels 2D et 3D. Les applications affichent toutes les surfaces planes détectées et permettent à l'utilisateur d'appuyer dessus pour placer un modèle 3D.

Configurer l'environnement de développement

Ouvrir un exemple de projet

  1. Dans Android Studio, clonez le dépôt GitHub du SDK ARCore.

    Il existe plusieurs façons de procéder:

    • Pour une installation Android Studio établie:

      • Dans le menu Git, sélectionnez Clone.
      • Dans la liste déroulante Version control, sélectionnez Git comme système de contrôle des versions.
      • Dans le champ URL, saisissez l'URL suivante vers le dépôt GitHub ARCore:

        https://github.com/google-ar/arcore-android-sdk.git

    • Vous pouvez également ouvrir un fichier Terminal et exécuter la commande git clone comme suit:

      git clone https://github.com/google-ar/arcore-android-sdk.git
  2. Ouvrez l'un des exemples de projet comme suit (vous devez explicitement ouvrir un projet pour le compiler et l'exécuter).

    • Dans le menu File, sélectionnez Open.
    • Dans le dossier arcore-android-sdk/samples, sélectionnez le dossier hello_ar_kotlin ou hello_ar_java, puis cliquez sur Open.

Préparer votre appareil ou votre émulateur

Vous pouvez exécuter des applications de RA sur un appareil compatible ou dans Android Emulator. Vous devez mettre à jour les services Google Play pour la RA dans l'émulateur avant d'exécuter l'application. Pour en savoir plus, consultez Exécuter des applications de RA dans Android Emulator .

Exécuter l'exemple

Assurez-vous que votre appareil Android est connecté à l'ordinateur de développement, puis cliquez sur Run dans Android Studio.

Android Studio crée votre projet dans un APK débogable, installe l'APK, puis exécute l'application sur votre appareil. Pour en savoir plus, consultez Créer et exécuter votre application.

Vous serez peut-être invité à installer ou à mettre à jour les services Google Play pour la RA s'ils sont manquants ou obsolètes. Sélectionnez CONTINUE pour l'installer depuis le Google Play Store ou mettez-le à jour manuellement comme décrit dans Mettre à jour les services Google Play pour la RA.

L'application hello_ar_java vous permet de placer un pion ARCore en trois dimensions sur les surfaces planes RA détectées. Il est implémenté avec Android GL SurfaceView, qui permet d'afficher l'aperçu de l'appareil photo et les objets de RA de base tels que les plans et les ancres. L'exemple de framework de rendu de hello_ar_java est disponible dans com/google/ar/core/examples/java/common/samplerender.

Utiliser l'emplacement instantané

L'API Instant Placement permet à l'utilisateur de placer un objet RA sur l'écran sans avoir à attendre qu'ARCore détecte la géométrie de la surface. Le placement des objets est affiné en temps réel à mesure que l'utilisateur se déplace davantage dans l'environnement.

Appuyez sur l'écran pour placer un objet. Veillez à continuer à déplacer l'appareil après avoir vu l'objet holographique apparaître à l'écran, afin qu'ARCore puisse obtenir suffisamment de données sur votre environnement pour ancrer avec précision l'objet virtuel.

Une fois qu'ARCore détecte la géométrie de la surface et établit un suivi dans la région où l'objet est placé, sa position est automatiquement mise à jour pour plus de précision.

Emplacement instantané

Dans la figure 1, l'emplacement instantané est désactivé et la géométrie de la surface n'est pas définie. Les objets placés sur le sol à droite de la table de billard (quatre petits points bleus) semblent renversés, leurs postures ne sont pas définies.

Dans la figure 2, l'emplacement instantané est activé dans le menu situé sous l'icône en forme de roue dentée.

Dans la figure 3, lorsque l'emplacement instantané est activé, un nouvel objet est placé dans la scène. Il apparaît en niveaux de gris, et non en couleur, pour indiquer qu'il n'a pas encore été corrigé pour une posture précise.

Dans la figure 4, le nouvel objet est coloré et sa position est précise lorsque la géométrie de la surface (décrite par les lignes de quadrillage traçables) est détectée.

Utiliser la profondeur

Lorsque l'option Depth est activée, ARCore prend en compte la géométrie et l'emplacement des objets dans la scène, et calcule l'emplacement des objets placés dans la scène par rapport aux autres objets de la scène. Elle permet d'obscurcir les objets placés dans la scène et apporte du réalisme à votre application.

Emplacement instantané

Sur la figure 1, la fonctionnalité "Profondeur" est désactivée. Un objet est placé sous la table de billard.

Dans la figure 2, lorsque l'appareil se déplace autour de la table de billard, l'objet semble suivre l'appareil, quels que soient les objets présents dans la scène.

Sur la figure 3, la fonctionnalité Profondeur est activée.

Dans la figure 4, l'objet apparaît maintenant masqué par la table de billard lorsque l'appareil se déplace dans la scène.

Étapes suivantes