Guide de démarrage rapide pour le NDK Android

Configurer l'environnement de développement

  • Installez Android Studio version 3.1 ou ultérieure avec la version 7.0 (niveau d'API 24) ou ultérieure d'Android SDK Platform.

  • Préparez Android Studio pour le développement natif en installant Android Native Development Kit (NDK) et CMake à l'aide de SDK Manager. Pour en savoir plus, consultez Premiers pas avec le NDK.

  • Vous devez vous procurer le SDK ARCore pour Android. Vous avez alors deux possibilités :

    • Téléchargez le SDK ARCore pour Android et extrayez-le.

      ou

    • Clonez le dépôt à l'aide de la commande suivante:

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

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 .

Ouvrir l'exemple de projet

Dans Android Studio, ouvrez l'exemple de projet hello_ar_c dans <ARCore SDK Folder>/samples/hello_ar_c.

L'exemple de projet comporte des dépendances de compilation sur certaines versions du logiciel, telles que Gradle et le SDK Android. Si les dépendances requises ne sont pas installées, Android Studio vous demandera l'autorisation de les télécharger et de les installer sur votre ordinateur.

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.

Lorsque vous déplacez votre appareil, l'application détecte automatiquement les surfaces planes et dessine une grille en losange. Appuyez sur la grille pour placer un pion ARCore en trois dimensions sur la surface.

Utiliser l'emplacement instantané

L'API Instant Placement permet à l'utilisateur de placer un objet de 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 davantage dans l'environnement. Une fois qu'ARCore détecte la posture correcte dans la région où l'objet RA est placé, l'objet est automatiquement mis à jour pour indiquer sa précision.

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.

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