Exécuter l’exemple d’application : HoloLens - Unity (C#)
Dans ce guide de démarrage rapide, vous allez exécuter l’exemple d’application Azure Spatial Anchors pour HoloLens avec Unity (C#). Spatial Anchors est un service de développement multiplateforme qui vous permet de créer des expériences de réalité mixte avec des objets qui conservent leur emplacement sur les appareils. Quand vous aurez terminé, vous aurez une application HoloLens 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 HoloLens Visual Studio.
- Déployer l’application et l’exécuter sur un appareil HoloLens.
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 :
- Vous avez besoin d’un appareil HoloLens avec le mode développeur activé. Pour HoloLens 2, la mise à jour Windows 10 de mai 2020 ou ultérieure doit être installée sur l’appareil. Pour mettre à jour votre appareil HoloLens avec la dernière version, ouvrez l’application Paramètres, accédez à Mise à jour et sécurité, puis sélectionnez Rechercher les mises à jour.
- Vous avez besoin d’un ordinateur Windows sur lequel Visual Studio 2019 ou version ultérieure est installé. Votre installation de Visual Studio doit comprendre la charge de travail Développement pour la plateforme Windows universelle et le Kit de développement logiciel (SDK) Windows 10 SDK (10.0.18362.0 ou plus récent) . Vous devez aussi installer Git pour Windows et Git LFS.
- Unity doit être installé. 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.
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.
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 HoloLens.
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.
Ouvrez Build Settings (Paramètres de build) en sélectionnant File (Fichier)>Build Settings (Paramètres de build).
Dans la section Platform (Plateforme), sélectionnez Universal Windows Platform (Plateforme Windows universelle). Remplacez Target Device (Appareil cible) par HoloLens.
Sélectionnez Switch Platform (Changer de plateforme) pour passer à la plateforme Universal Windows Platform (Plateforme Windows universelle). Unity peut vous demander d’installer des composants de prise en charge UWP s’ils sont manquants.
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 HoloLens Visual 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 Build. Dans la boîte de dialogue, sélectionnez un dossier où exporter le projet HoloLens Visual Studio.
À l’issue de l’exportation, un dossier avec le projet HoloLens exporté s’affiche.
Déployer l’application HoloLens
Dans le dossier, double-cliquez sur HelloAR U3D.sln pour ouvrir le projet dans Visual Studio.
Remplacez Configuration de la solution par Mise en production, Plateforme de solution par 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.
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.
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.