Exécuter l’exemple d’application : HoloLens - Visual Studio (C++/WinRT)
Article
Ce guide de démarrage rapide explique comment exécuter l’exemple d’application Azure Spatial Anchors pour HoloLens avec Visual Studio (C++/WinRT et DirectX). 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 HoloLens 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
Pour suivre ce guide de démarrage rapide, veillez à avoir :
Une machine Windows dotée de Visual Studio 2019 avec la charge de travail de développement pour la plateforme Windows universelle et le composant SDK Windows 10 (version 10.0.18362.0 ou plus récente) . Vous devez aussi installer Git pour Windows et Git LFS.
Un appareil HoloLens avec le mode développeur activé. L’appareil utilisé dans cet article est un HoloLens doté de la mise à jour Windows 10 de mai 2020. Pour mettre à jour votre appareil HoloLens vers la dernière version, ouvrez l’application Paramètres, accédez à Mise et sécurité, puis sélectionnez le bouton Vérifier les mises à jour.
Votre application doit définir la fonctionnalité spatialPerception dans son manifeste AppX.
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.
Une fois la ressource créée, le portail Azure indique que votre déploiement est terminé.
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.
Copiez également le Domaine du compte de la ressource dans un éditeur de texte en vue d’une utilisation ultérieure.
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.
Commencez par préparer votre environnement pour Azure CLI :
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 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.
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
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 :
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 :
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 HoloLens\DirectX\SampleHoloLens.sln dans Visual Studio.
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.
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 HoloLens
Pour Configuration de la solution, choisissez Mise en production, pour Plateforme de solution choisissez x86, puis sélectionnez Appareil dans les options de cible de déploiement.
Si vous utilisez HoloLens 2, utilisez ARM64 comme plateforme de solution au lieu de x86.
Allumez l’appareil HoloLens, connectez-vous, puis connectez l’appareil au PC au moyen d’un câble USB.
Sélectionnez Déboguer>Démarrer le débogage pour déployer votre application et commencer le débogage.
Suivez les instructions dans l’application pour placer et rappeler une ancre.
Dans Visual Studio, arrêtez l’application en sélectionnant Arrêter le débogage ou en appuyant sur Maj+F5.
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.
