Guide de démarrage rapide pour le NDK Android

Configurer l'environnement de développement

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

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

  • Vous devez obtenir 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 sur 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 de logiciels, tels 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 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.

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

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. Une fois qu'ARCore a détecté la bonne position dans la région où l'objet RA est placé, l'objet est automatiquement mis à jour pour être précis.

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.

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