Exécuter l’exemple d’application : Android - Unity (C#)

Article
03/10/2023

Ce guide de démarrage rapide explique comment exécuter l’exemple d’application Azure Spatial Anchors pour les appareils Android avec Unity (C#). 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 ARCore Android générée avec Unity capable d’enregistrer et de rappeler une ancre spatiale.

Vous découvrirez comment effectuer les actions suivantes :

Créer un compte Spatial Anchors
Préparer les paramètres de build Unity
Configurer l’identificateur et la clé du compte Spatial Anchors
Exporter le projet Android Studio
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 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. Vous pouvez obtenir des informations et des instructions supplémentaires ici.
Un ordinateur Windows ou macOS.
- Si vous exécutez Windows, vous avez aussi besoin de Git pour Windows et de 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.
Installation d’Unity, y compris la prise en charge des builds Android avec les outils Android SDK & NDK et les modules OpenJDK . Pour obtenir les versions prises en charge et les fonctionnalités requises, visitez la Page de configuration de projet Unity.

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.

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.

Commencez par préparer votre environnement pour Azure CLI :

Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
- Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
- Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
- Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Une fois que vous êtes connecté, utilisez la commande az account set pour sélectionner l’abonnement dans lequel configurer le compte Spatial Anchors :
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
Exécutez la commande az group create pour créer un groupe de ressources ou utiliser un groupe de ressources existant :
```
az group create --name myResourceGroup --location eastus2
```
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.

Vous pouvez voir vos comptes Spatial Anchors actuels pour un groupe de ressources à l’aide de la commande az spatial-anchors-account list :
```
az spatial-anchors-account list --resource-group myResourceGroup
```
Vous pouvez également voir les comptes Spatial Anchors de votre abonnement :
```
az spatial-anchors-account list
```

Exécutez la commande az spatial-anchors-account create pour créer votre compte Spatial Anchors :

az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2

Affichez les propriétés de la ressource à l’aide de la commande az spatial-anchors-account show :
```
az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
Copiez la valeur ID de compte de la ressource et la valeur Domaine du compte de la ressource dans un éditeur de texte à des fins d’utilisation ultérieure.

Exécutez la commande az spatial-anchors-account key show pour obtenir vos clés primaires et secondaires :

az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Copiez les valeurs de clé dans un éditeur de texte à des fins d’utilisation ultérieure.

Si vous avez besoin de regénérer des clés, utilisez la commande az spatial-anchors-account key renew :

az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary

Vous pouvez supprimer un compte à l’aide de la commande az spatial-anchors-account delete :

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Commencez par préparer votre environnement pour Azure PowerShell :

Si vous choisissez d’utiliser Azure PowerShell localement :
- Installez la dernière version du module Az PowerShell.
- Connectez-vous à votre compte Azure à l’aide de la cmdlet Connect-AzAccount.
Si vous choisissez d’utiliser Azure Cloud Shell :
- Pour plus d’informations, consultez Vue d’ensemble d’Azure Cloud Shell.

Important

Tant que le module PowerShell Az.MixedReality est en préversion, vous devez l’installer séparément à l’aide de l’applet de commande Install-Module. Une fois que ce module PowerShell sera en disponibilité générale, il fera partie intégrante des versions futures du module PowerShell Az et sera disponible par défaut dans Azure Cloud Shell.

Install-Module -Name Az.MixedReality

Une fois que vous êtes connecté, utilisez la commande Set-AzContext pour sélectionner l’abonnement dans lequel configurer le compte Spatial Anchors :
```
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
```
Exécutez l’applet de commande New-AzResourceGroup pour créer un groupe de ressources, ou utilisez un groupe de ressources existant :
```
New-AzResourceGroup -Name myResourceGroup -Location eastus2
```
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.

Vous pouvez voir vos comptes Spatial Anchors actuels pour un groupe de ressources à l’aide de l’applet de commande Get-AzSpatialAnchorsAccount :
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
```
Vous pouvez également voir les comptes Spatial Anchors de votre abonnement :
```
Get-AzSpatialAnchorsAccount
```

Exécutez l’applet de commande New-AzSpatialAnchorsAccount pour créer votre compte Spatial Anchors :

New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2

Affichez les propriétés de ressources à l’aide de l’applet de commande Get-AzSpatialAnchorsAccount :
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
Copiez les valeurs accountId et accountDomain de la propriété dans un éditeur de texte pour une utilisation ultérieure.

Exécutez l’applet de commande Get-AzSpatialAnchorsAccountKey pour récupérer vos clés primaires et secondaires :

Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Copiez les valeurs de clé dans un éditeur de texte à des fins d’utilisation ultérieure.

Si vous devez regénérer des clés, utilisez l’applet de commande New-AzSpatialAnchorsAccountKey :

New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary

Vous pouvez supprimer un compte à l’aide de l’applet de commande Remove-AzSpatialAnchorsAccount :

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Télécharger l’exemple de projet et importer le kit de développement logiciel

Cloner le dépôt d’exemples

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

Importer le SDK Azure Spatial Anchors

Suivez les instructions fournies ici pour télécharger et importer les packages du SDK ASA nécessaires pour la plateforme Android.

Configurer Unity

Dans Unity, ouvrez le projet dans le dossier Unity. Il se peut qu’Unity signale une différence entre la version du projet et la version installée sur votre ordinateur. Cet avertissement ne pose pas de problème tant que votre version de l’éditeur Unity est plus récente que celle avec laquelle le projet a été créé. Si votre version est plus récente, sélectionnez Continuer. Si votre version est plus ancienne que celle dont le projet a besoin, cliquez sur Quitter, puis mettez à niveau votre éditeur Unity.

Screenshot of the Unity pane.

Ouvrez Build Settings (Paramètres de build) en sélectionnant File (Fichier)>Build Settings (Paramètres de build).

Dans la section Plateforme, sélectionnez Android, puis sélectionnez Changer de plateforme pour définir la plateforme Android. Unity peut vous demander d’installer des composants de prise en charge Android s’ils sont manquants.

Screenshot of the Unity Build Settings pane - Android

Fermez la fenêtre Build Settings.

Configurer les informations de compte

L’étape suivante consiste à configurer l’application pour qu’elle utilise vos informations de compte. Vous avez copié les valeurs Clé de compte, ID de compte et Domaine de compte vers un éditeur de texte précédemment, dans la section Créer une ressource Spatial Anchors.

Dans le volet Projet, accédez à Assets\AzureSpatialAnchors.SDK\Resources.

Sélectionnez SpatialAnchorConfig. Dans le volet Inspecteur, entrez Account Key comme valeur de Clé de compte Spatial Anchors, Account ID comme valeur d’ID de compte Spatial Anchors, et Account Domain comme valeur de Domaine de compte Spatial Anchors.

Exporter le projet Android Studio

Ouvrez Build Settings (Paramètres de build) en sélectionnant File (Fichier)>Build Settings (Paramètres de build).

Sous Scenes In Build (Scènes dans la build), assurez-vous que toutes les scènes ont une coche à côté d’elles.

Sélectionnez votre appareil dans Appareil d’exécution, puis sélectionnez Générer et exécuter. Vous êtes ensuite invité à enregistrer in fichier .apk, auquel vous pouvez donner n’importe quel nom.

Dans l’application, sélectionnez BasicDemo en utilisant les flèches, puis appuyez sur le bouton Go! pour exécuter la démonstration. Suivez les instructions dans l’application pour placer et rappeler une ancre.

Screenshot 1 Screenshot 2 Screenshot 3

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

Dépannage

Problèmes de rendu

Pendant l’exécution de l’application, si vous ne voyez pas de caméra en arrière-plan (par exemple, vous voyez au lieu de cela un arrière-plan blanc, bleu ou d’une autre texture), vous devez probablement réimporter les ressources dans Unity. Arrêtez l’application. Dans le menu supérieur d’Unity, choisissez Assets -> Reimport all. Ensuite, exécutez de nouveau l’application.

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.

Tutoriel : Partager Spatial Anchors sur des appareils

Guide pratique pour configurer Azure Spatial Anchors dans un projet Unity