Démarrage rapide : Créer une application Android avec Azure Spatial AnchorsQuickstart: Create an Android app with Azure Spatial Anchors

Ce démarrage rapide explique comment créer une application Android à l’aide d’Azure Spatial Anchors en Java ou C++/NDK.This quickstart covers how to create an Android app using Azure Spatial Anchors in either Java or 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 d’un appareil à un autre au fil du temps.Azure Spatial Anchors is a cross-platform developer service that allows you to create mixed reality experiences using objects that persist their location across devices over time. Quand vous aurez terminé, vous aurez une application Android ARCore capable d’enregistrer et de rappeler une ancre spatiale.When you're finished, you'll have an ARCore Android app that can save and recall a spatial anchor.

Vous découvrirez comment effectuer les actions suivantes :You'll learn how to:

  • Créer un compte Spatial AnchorsCreate a Spatial Anchors account
  • Configurer l’identificateur et la clé du compte Spatial AnchorsConfigure the Spatial Anchors account identifier and account key
  • Déployer et exécuter sur un appareil AndroidDeploy and run on an Android device

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.If you don't have an Azure subscription, create a free account before you begin.

PrérequisPrerequisites

Pour suivre ce guide de démarrage rapide, veillez à avoir :To complete this quickstart, make sure you have:

  • Un ordinateur Windows ou macOS avec Android Studio 3.4+.A Windows or macOS machine with Android Studio 3.4+.
    • Si vous exécutez Windows, vous avez aussi besoin de Git pour Windows.If running on Windows, you'll also need Git for Windows.
    • Si vous exécutez macOS, installez Git via HomeBrew.If running on macOS, get Git installed 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)".Enter the following command into a single line of the Terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Exécutez ensuite brew install git.Then, run brew install git.
    • 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.To build the NDK sample, you'll also need to install the NDK and CMake 3.6 or greater SDK Tools in Android Studio.
  • Un appareil Android prêt pour le développement et compatible ARCore.A developer enabled and ARCore capable Android device.
    • Des pilotes d’appareils supplémentaires peuvent être nécessaires pour que votre ordinateur puisse communiquer avec votre appareil Android.Additional device drivers may be required for your computer to communicate with your Android device. Cliquez ici pour obtenir des informations et instructions supplémentaires.See here for additional information and instructions.
  • Votre application doit cibler ARCore 1.8.Your app must target ARCore 1.8.

Créer une ressource Spatial AnchorsCreate a Spatial Anchors resource

Accédez au portail Azure.Go to the Azure portal.

Dans le volet de navigation gauche du portail Azure, sélectionnez Créer une ressource.In the left navigation pane in the Azure portal, select Create a resource.

Utilisez la zone de recherche pour rechercher Spatial Anchors.Use the search box to search for Spatial Anchors.

Recherche de Spatial Anchors

Sélectionnez Spatial Anchors.Select Spatial Anchors. Dans la boîte de dialogue, sélectionnez Créer.In the dialog box, select Create.

Dans la boîte de dialogue Compte Spatial Anchors :In the Spatial Anchors Account dialog box:

  • Entrez un nom de ressource unique, en utilisant des caractères alphanumériques normaux.Enter a unique resource name, using regular alphanumeric characters.

  • Sélectionnez l’abonnement auquel attacher la ressource.Select the subscription that you want to attach the resource to.

  • Créer un groupe de ressources en sélectionnant Créer.Create a resource group by selecting Create new. Nommez-le myResourceGroup et sélectionnez OK.Name it myResourceGroup and select 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és et gérés.A resource group is a logical container into which Azure resources like web apps, databases, and storage accounts are deployed and managed. Par exemple, vous pouvez choisir de supprimer le groupe de ressources complet ultérieurement en une seule étape.For example, you can choose to delete the entire resource group in one simple step later.

  • Sélectionnez un emplacement (région) où placer la ressource.Select a location (region) in which to place the resource.

  • Sélectionnez Nouveau pour commencer à créer la ressource.Select New to begin creating the resource.

    Créer une ressource

Une fois la ressource créée, le portail Azure indique que votre déploiement est terminé.After the resource is created, Azure Portal will show that your deployment is complete. Cliquez sur Accéder à la ressource.Click Go to resource.

Déploiement terminé

Ensuite, vous pouvez afficher les propriétés de la ressource.Then, you can view the resource properties. Copiez l’ID de compte de la ressource dans un éditeur de texte, car vous en aurez besoin par la suite.Copy the resource's Account ID value into a text editor because you'll need it later.

Propriétés de la ressource

Sous Paramètres, sélectionnez Clé.Under Settings, select Key. Copiez la valeur de la Clé primaire dans un éditeur de texte.Copy the Primary key value into a text editor. Cette valeur est la Account Key.This value is the Account Key. Vous en aurez besoin ultérieurement.You'll need it later.

Clé de compte

Ouvrir l’exemple de projetOpen the sample project

Cloner le dépôt d’exemples en exécutant la commande suivante :Clone the samples repository by running the following command:

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

Ouvrez Android Studio.Open Android Studio.

Sélectionnez Open an existing Android Studio project, puis le projet situé à l’emplacement Android/Java/.Select Open an existing Android Studio project and select the project located at Android/Java/.

Configurer l’identificateur et la clé du compteConfigure account identifier and key

L’étape suivante configure l’application pour qu’elle utilise votre identificateur et votre clé de compte.The next step is to configure the app to use your account identifier and account key. Vous les avez copiés dans un éditeur de texte pendant la configuration de la ressource Spatial Anchors.You copied them into a text editor when setting up the Spatial Anchors resource.

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

Localisez le champ SpatialAnchorsAccountKey et remplacez Set me par la clé du compte.Locate the SpatialAnchorsAccountKey field and replace Set me with the account key.

Localisez le champ SpatialAnchorsAccountId et remplacez Set me par l’identificateur du compte.Locate the SpatialAnchorsAccountId field and replace Set me with the account identifier.

Déployer l’application sur votre appareil AndroidDeploy the app to your Android device

Allumez l’appareil Android, connectez-vous, puis connectez l’appareil au PC au moyen d’un câble USB.Power on the Android device, sign in, and connect it to the PC using a USB cable.

Sélectionnez Run dans la barre d’outils Android Studio.Select Run from the Android Studio toolbar.

Déployer et exécuter dans Android Studio

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.Select the Android device in the Select Deployment Target dialog, and select OK to run the app on the Android device.

Suivez les instructions dans l’application pour placer et rappeler une ancre.Follow the instructions in the app to place and recall an anchor.

Arrêtez l’application en sélectionnant Stop dans la barre d’outils Android Studio.Stop the app by selecting Stop from the Android Studio toolbar.

Bouton Stop dans Android Studio

Supprimer des ressourcesClean up resources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources.In the preceding steps, you created Azure resources in a resource group. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

Dans le menu de gauche du portail Azure, cliquez sur Groupes de ressources, puis sur myResourceGroup.From the left menu in the Azure portal, select Resource groups and then select myResourceGroup.

Sur la page Groupes de ressources, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.On the resource group page, make sure that the listed resources are the ones you want to delete.

Sélectionnez Supprimer, tapez myResourceGroup dans la zone de texte, puis sélectionnez Supprimer.Select Delete, type myResourceGroup in the text box, and then select Delete.

Étapes suivantesNext steps

Dans ce guide de démarrage rapide, vous avez créé un compte Spatial Anchors.In this quickstart, you created a Spatial Anchors account. Vous avez ensuite configuré et déployé une application pour enregistrer et rappeler des ancres spatiales.You then configured and deployed an app to save and recall spatial anchors. 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.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.