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 avec le SDK ARCore. Ces exemples d'applications utilisent OpenGL, une interface de programmation pour le rendu de graphiques vectoriels 2D et 3D. Les applications affichent tous les plans détectés et permettent à l'utilisateur d'appuyer sur un plan 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.

    Pour ce faire, vous pouvez procéder de plusieurs manières:

    • Pour une installation Android Studio établie:

      • Dans le menu Git, sélectionnez Clone.
      • Dans le menu déroulant Version control, sélectionnez Git comme système de contrôle des versions.

      • Dans le champ URL, saisissez l'URL suivante du dépôt GitHub d'ARCore:

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

    • Vous pouvez également ouvrir un 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 projets comme suit (vous devez ouvrir explicitement 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 sur 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 compile votre projet dans un APK débogable, l'installe, puis exécute l'application sur votre appareil. Pour en savoir plus, consultez la section Créer et exécuter votre application.

Vous pouvez ê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 la section Mettre à jour les Services Google Play pour la RA.

L'application hello_ar_java vous permet de placer un pion ARCore tridimensionnel sur des surfaces planes de 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 RA de base tels que les plans et les ancrages. L'exemple de framework de rendu de hello_ar_java se trouve 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 à l'écran sans avoir à attendre qu'ARCore détecte la géométrie de la surface. L'emplacement des objets est affiné en temps réel à mesure que l'utilisateur se déplace dans l'environnement.

Appuyez sur l'écran pour placer un objet. Assurez-vous de continuer à déplacer l'appareil après l'apparition de l'objet holographique à l'écran afin qu'ARCore puisse obtenir suffisamment de données sur votre environnement pour ancrer précisément l'objet virtuel.

Une fois qu'ARCore a détecté la géométrie de la surface et établi un élément à suivre dans la région où l'objet est placé, la position de l'objet 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 poses sont indéfinies.

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

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

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

Utiliser la profondeur

Lorsque la profondeur est activée, ARCore tient compte de la géométrie et de 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. Il permet aux objets placés d'être masqués par les objets de la scène et donne du réalisme à votre application.

Emplacement instantané

Dans la figure 1, la 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, quel que soit l'objet de la scène.

Dans la figure 3, la profondeur est activée.

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

Étapes suivantes