Ausführen der Beispiel-App: HoloLens – Visual Studio (C++/WinRT)
Artikel
In dieser Schnellstartanleitung wird das Ausführen der Azure Spatial Anchors-Beispiel-App für HoloLens mit Visual Studio (C++/WinRT und DirectX) behandelt. Azure Spatial Anchors ist ein plattformübergreifender Entwicklerdienst, mit dem Sie Mixed Reality-Umgebungen mit Objekten erstellen können, die ihre Position im Zeitverlauf geräteübergreifend beibehalten. Nach Abschluss des Vorgangs verfügen Sie über eine HoloLens-App, mit der ein räumlicher Anker gespeichert und abgerufen werden kann.
Sie lernen Folgendes:
Erstellen eines Spatial Anchors-Kontos
Konfigurieren des Bezeichners und Kontoschlüssels für das Spatial Anchors-Konto
Bereitstellen und Ausführen auf einem HoloLens-Gerät
Stellen Sie für diese Schnellstartanleitung sicher, dass Sie über Folgendes verfügen:
Einen Windows-Computer mit Installation von Visual Studio 2019 mit der Workload Entwicklung für die universelle Windows-Plattform und der Komponente Windows 10 SDK (10.0.18362.0 oder höher) . Sie müssen auch Git für Windows und Git LFS installieren.
Ein HoloLens-Gerät mit aktiviertem Entwicklermodus. Für diesen Artikel benötigen Sie ein HoloLens-Gerät mit dem Windows 10-Update vom Mai 2020. Öffnen Sie zum Aktualisieren auf das neueste HoloLens-Release die App Einstellungen, navigieren Sie zu Update und Sicherheit, und wählen Sie anschließend die Schaltfläche Nach Updates suchen.
Für Ihre App muss im AppX-Manifest die Funktion spatialPerception festgelegt werden.
Wählen Sie im linken Bereich Ressource erstellen aus.
Suchen Sie über das Suchfeld nach Spatial Anchors.
Wählen Sie Spatial Anchors und dann Erstellen aus.
Führen Sie im Bereich Spatial Anchors-Konto die folgenden Schritte aus:
Geben Sie einen eindeutigen Ressourcennamen in regulären alphanumerischen Zeichen ein.
Wählen Sie das Abonnement aus, an das die Ressource angefügt werden soll.
Erstellen Sie eine Ressourcengruppe durch Auswählen von Neu erstellen. Nennen Sie sie myResourceGroup, und wählen Sie OK aus.
Eine Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen wie Web-Apps, Datenbanken und Speicherkonten bereitgestellt und verwaltet werden. Sie können z.B. die gesamte Ressourcengruppe später in einem einfachen Schritt löschen.
Wählen Sie einen Standort (Region) für die Ressource aus.
Wählen Sie Erstellen aus, um mit der Ressourcenerstellung zu beginnen.
Nachdem die Ressource erstellt wurde, zeigt das Azure-Portal an, dass die Bereitstellung abgeschlossen ist.
Wählen Sie Zu Ressource wechseln aus. Nun können Sie die Ressourceneigenschaften anzeigen.
Kopieren Sie den Wert für Konto-ID der Ressource zur späteren Verwendung in einen Text-Editor.
Kopieren Sie außerdem den Wert für Kontodomäne der Ressource zur späteren Verwendung in einen Text-Editor.
Wählen Sie unter Einstellungen die Option Zugriffsschlüssel aus. Kopieren Sie die Werte für Primärschlüssel und Kontoschlüssel zur späteren Verwendung in einen Text-Editor.
Bereiten Sie zunächst Ihre Umgebung für die Azure-Befehlszeilenschnittstelle vor:
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.
Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.
Nachdem Sie sich angemeldet haben, verwenden Sie den Befehl az account set, um das Abonnement auszuwählen, in dem das Spatial Anchors-Konto eingerichtet werden soll:
az account set --subscription 00000000-0000-0000-0000-000000000000
Führen Sie den Befehl az group create aus, um eine Ressourcengruppe zu erstellen, oder verwenden Sie eine vorhandene Ressourcengruppe:
az group create --name myResourceGroup --location eastus2
Eine Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen wie Web-Apps, Datenbanken und Speicherkonten bereitgestellt und verwaltet werden. Sie können z.B. die gesamte Ressourcengruppe später in einem einfachen Schritt löschen.
Sie können Ihre aktuellen Spatial Anchors-Konten für eine Ressourcengruppe mit dem Befehl az spatial-anchors-account list anzeigen:
az spatial-anchors-account list --resource-group myResourceGroup
Sie können auch die Spatial Anchors-Konten für Ihr Abonnement anzeigen:
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
Solange nur eine Vorschauversion des PowerShell-Moduls Az.MixedReality verfügbar ist, müssen Sie es separat mit dem Cmdlet Install-Module installieren. Sobald dieses PowerShell-Modul allgemein verfügbar ist, wird es in die zukünftigen Releases des Az PowerShell-Moduls integriert und in Azure Cloud Shell standardmäßig zur Verfügung gestellt.
Install-Module -Name Az.MixedReality
Nachdem Sie sich angemeldet haben, verwenden Sie den Befehl Set-AzContext, um das Abonnement auszuwählen, in dem das Spatial Anchors-Konto eingerichtet werden soll:
Eine Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen wie Web-Apps, Datenbanken und Speicherkonten bereitgestellt und verwaltet werden. Sie können z.B. die gesamte Ressourcengruppe später in einem einfachen Schritt löschen.
Sie können Ihre aktuellen Spatial Anchors-Konten für eine Ressourcengruppe anzeigen, indem Sie das Cmdlet Get-AzSpatialAnchorsAccount verwenden:
Klonen Sie das Beispielrepository, indem Sie die folgenden Befehle ausführen:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
Öffnen Sie HoloLens\DirectX\SampleHoloLens.sln in Visual Studio.
Konfigurieren des Kontobezeichners und -schlüssels
Im nächsten Schritt wird die App zur Verwendung des Kontobezeichners und Kontoschlüssels konfiguriert. Diese haben Sie beim Einrichten der Spatial Anchors-Ressource in einen Text-Editor kopiert.
Öffnen Sie HoloLens\DirectX\SampleHoloLens\ViewController.cpp.
Suchen Sie nach dem Feld SpatialAnchorsAccountKey, und ersetzen Sie Set me durch den Kontoschlüssel.
Suchen Sie nach dem Feld SpatialAnchorsAccountId, und ersetzen Sie Set me durch den Kontobezeichner.
Suchen Sie nach dem Feld SpatialAnchorsAccountDomain, und ersetzen Sie Set me durch die Kontodomäne.
Bereitstellen der App für HoloLens
Ändern Sie Projektmappenkonfiguration in Release und Solution Platform (Projektmappenplattform) in x86, und wählen Sie in den Optionen für das Bereitstellungsziel die Option Gerät.
Verwenden Sie bei Einsatz von HoloLens 2 ARM64 als Projektmappenplattform anstelle von x86.
Schalten Sie das HoloLens-Gerät ein, melden Sie sich an, und stellen Sie dafür per USB-Kabel eine Verbindung mit dem PC her.
Wählen Sie Debuggen>Debuggen starten, um Ihre App bereitzustellen und den Debugvorgang zu starten.
Befolgen Sie in der App die Anleitung zum Anordnen und Abrufen eines Ankers.
Beenden Sie die App in Visual Studio, indem Sie entweder Debuggen beenden wählen oder UMSCHALT+F5 drücken.
Bereinigen von Ressourcen
In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie diese Ressourcen in Zukunft nicht mehr benötigen, können Sie sie löschen, indem Sie die Ressourcengruppe löschen.
Wählen Sie im Azure-Portalmenü oder auf der Startseite die Option Ressourcengruppen aus. Wählen Sie auf der Seite Ressourcengruppen die Option myResourceGroup aus.
Stellen Sie auf der Seite myResourceGroup sicher, dass die Ressourcen aufgelistet sind, die Sie löschen möchten.
Wählen Sie die Option Löschen aus, geben Sie zur Bestätigung im Textfeld myResourceGroup ein, und wählen Sie anschließend Löschen aus.
Nächste Schritte
In diesem Schnellstart haben Sie ein Spatial Anchors-Konto erstellt. Dann haben Sie eine App zum Speichern und Abrufen von Spatial Anchors konfiguriert und bereitgestellt. Fahren Sie mit dem nächsten Tutorial fort, um zu erfahren, wie die App verbessert wird, damit Spatial Anchors für andere Geräte freigegeben werden können.
