Exécuter l’exemple d’application : Android - Android Studio (Java ou C++/NDK)

Ce guide de démarrage rapide explique comment exécuter l’exemple d’application Azure Spatial Anchors pour les appareils Android avec Android Studio (Java ou C++/NDK). Azure Spatial Anchors est un service de développement multiplateforme qui vous permet de créer des expériences de réalité mixte en utilisant des objets qui conservent leur emplacement sur les appareils. Quand vous aurez terminé, vous aurez une application Android ARCore capable d’enregistrer et de rappeler une ancre spatiale.

Vous découvrirez comment effectuer les actions suivantes :

  • Créer un compte Spatial Anchors
  • Configurer l’identificateur et la clé du compte Spatial Anchors
  • Déployer et exécuter sur un appareil Android

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit Azure avant de commencer.

Prérequis

Pour suivre ce guide de démarrage rapide, veillez à avoir :

  • Un ordinateur Windows ou macOS avec Android Studio 3.4+.
    • Si vous exécutez Windows, vous avez aussi besoin de Git pour Windows et Git LFS.
    • Si vous exécutez macOS, installez Git via HomeBrew. Entrez la commande suivante sur une seule ligne du Terminal : /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Puis exécutez brew install git et brew install git-lfs.
    • Pour générer l’exemple NDK, vous devez aussi installer le NDK et SDK Tools CMake 3.6 ou version supérieure dans Android Studio.
  • Un appareil Android prêt pour le développement et compatible ARCore.
    • Des pilotes d’appareils supplémentaires peuvent être nécessaires pour que votre ordinateur puisse communiquer avec votre appareil Android. Cliquez ici pour obtenir des informations et instructions supplémentaires.
  • Votre application doit cibler ARCore 1.11.0.

Créer une ressource Spatial Anchors

Accédez au portail Azure.

Dans le volet de gauche, sélectionnez Créer une ressource.

Utilisez la zone de recherche pour rechercher Spatial Anchors.

Screenshot showing the results of a search for Spatial Anchors.

Sélectionnez Spatial Anchors, puis Créer.

Dans le volet Spatial Anchors Account (compte Spatial Anchors), procédez comme suit :

  • Entrez un nom de ressource unique, en utilisant des caractères alphanumériques normaux.

  • Sélectionnez l’abonnement auquel attacher la ressource.

  • Créer un groupe de ressources en sélectionnant Créer. Nommez-le myResourceGroup, puis sélectionnez OK.

    Un groupe de ressources est un conteneur logique dans lequel les ressources Azure, comme les applications web, les bases de données et les comptes de stockage, sont déployées et managées. Par exemple, vous pouvez choisir de supprimer le groupe de ressources complet ultérieurement en une seule étape.

  • Sélectionnez un emplacement (région) où placer la ressource.

  • Sélectionnez Créer pour commencer à créer la ressource.

Screenshot of the Spatial Anchors pane for creating a resource.

Une fois la ressource créée, le portail Azure indique que votre déploiement est terminé.

Screenshot showing that the resource deployment is complete.

Sélectionnez Accéder à la ressource. Vous pouvez à présent afficher les propriétés de la ressource.

Copiez la valeur ID de compte de la ressource dans un éditeur de texte en vue d’une utilisation ultérieure.

Screenshot of the resource properties pane.

Copiez également le Domaine du compte de la ressource dans un éditeur de texte en vue d’une utilisation ultérieure.

Screenshot showing the resource's account domain value.

Sous Paramètres, sélectionnez Clé d’accès. Copiez la valeur de Clé primaire, Clé de compte, dans un éditeur de texte en vue d’une utilisation ultérieure.

Screenshot of the Keys pane for the account.

Ouvrir l’exemple de projet

Clonez le dépôt d’exemples en exécutant les commandes suivantes :

git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples

Ouvrez Android Studio.

Sélectionnez Open an existing Android Studio project, puis le projet situé à l’emplacement Android/Java/.

Configurer l’identificateur et la clé du compte

L’étape suivante configure l’application pour qu’elle utilise votre identificateur et votre clé de compte. Vous les avez copiés dans un éditeur de texte pendant la configuration de la ressource Spatial Anchors.

Ouvrez Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java.

Localisez le champ SpatialAnchorsAccountKey et remplacez Set me par la clé du compte.

Localisez le champ SpatialAnchorsAccountId et remplacez Set me par l’identificateur du compte.

Recherchez le champ SpatialAnchorsAccountDomain et remplacez Set me par le domaine du compte.

Déployer l’application sur votre appareil Android

Allumez l’appareil Android, connectez-vous, puis connectez l’appareil au PC au moyen d’un câble USB.

Sélectionnez Run dans la barre d’outils Android Studio.

Android Studio Deploy and Run

Sélectionnez l’appareil Android dans la boîte de dialogue Select Deployment Target et sélectionnez OK pour exécuter l’application sur l’appareil Android.

Suivez les instructions dans l’application pour placer et rappeler une ancre.

Arrêtez l’application en sélectionnant Stop dans la barre d’outils Android Studio.

Android Studio Stop

Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.

Dans le menu ou la page d’accueil du portail Azure, sélectionnez Groupes de ressources. Ensuite, dans la page Groupes de ressources, sélectionnez myResourceGroup.

Dans la page myResourceGroup, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.

Sélectionnez Supprimer le groupe de ressources, tapez myResourceGroup dans la zone de texte pour confirmer, puis sélectionnez Supprimer.

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez créé un compte Spatial Anchors. Vous avez ensuite configuré et déployé une application pour enregistrer et rappeler des ancres spatiales. Pour en savoir plus sur la façon d’améliorer l’application pour qu’elle puisse partager des ancres spatiales avec d’autres appareils, passez au tutoriel suivant.