Guide de démarrage rapide pour Android

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Pour commencer à utiliser ARCore avec Android, vous pouvez exécuter l'exemple d'application hello_ar_kotlin ou hello_ar_java inclus dans le SDK ARCore. Ces exemples d'applications utilisent OpenGL, une interface de programmation permettant d'afficher des graphiques vectoriels en 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.

    Il existe plusieurs façons de procéder:

    • Pour une installation Android Studio reconnue:

      • 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 dans le dépôt GitHub ARCore:

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

    • Vous pouvez également ouvrir un fichier Terminal et émettre 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 l'émulateur Android. Vous devez mettre à jour Services Google Play pour la RA sur l'émulateur avant d'exécuter l'application. Consultez la section Exécuter des applications de RA dans l'émulateur Android pour en savoir plus.

Exécuter l'exemple

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

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

Vous pouvez être invité à installer ou à mettre à jour les services Google Play pour la RA s'il est manquant ou obsolète. Sélectionnez CONTINUE pour l'installer depuis le Google Play Store ou la mettre à 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 en trois dimensions sur les surfaces de plans 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 avions 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 en RA à l'écran sans avoir à attendre qu'ARCore détecte la géométrie de 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. Continuez à déplacer l'appareil après avoir vu l'objet holographique apparaître à l'écran, afin que ARCore puisse obtenir suffisamment de données sur votre environnement pour ancrer précisément l'objet virtuel.

Une fois qu'ARCore détecte la géométrie de surface et établit une trace 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, "Emplacement instantané" est désactivé et la géométrie de surface n'est pas définie. Les objets placés sur le sol à droite de la table de billard (quatre petits points bleus) apparaissent renversés, et leurs postures ne sont pas définies.

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

Dans la figure 3, lorsque la fonctionnalité Emplacement instantané est activée, un nouvel objet est placé dans la scène. Elle apparaît en nuances de gris, et non en couleur, pour indiquer que la position n'a pas encore été corrigée.

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

Utiliser la profondeur

Lorsque la profondeur est activée, ARCore prend en compte la géométrie et l'emplacement des objets de la scène, et calcule la position des objets placés dans la scène par rapport aux autres objets de la scène. Elle permet aux objets placés d'être cachés par des objets se trouvant sur la scène et confère un 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 dans la table de billard, l'objet semble le suivre indépendamment des objets de la scène.

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

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

Étapes suivantes