Ausführen der Beispiel-App: HoloLens – Unity (C#)
In dieser Schnellstartanleitung führen Sie die Azure Spatial Anchors-Beispiel-App für HoloLens mit Unity (C#) aus. 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 mit Unity erstellte HoloLens-App, mit der ein räumlicher Anker gespeichert und abgerufen werden kann.
Sie lernen Folgendes:
- Erstellen eines Spatial Anchors-Kontos
- Vorbereiten von Unity-Buildeinstellungen
- Konfigurieren des Bezeichners und Schlüssels für das Spatial Anchors-Konto
- Exportieren des HoloLens-Visual Studio-Projekts
- Bereitstellen und Ausführen der App auf einem HoloLens-Gerät
Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.
Voraussetzungen
So führen Sie diesen Schnellstart durch:
- Sie benötigen ein HoloLens-Gerät mit aktiviertem Entwicklermodus. Für HoloLens 2 muss auf dem Gerät das Windows 10-Update vom Mai 2020 oder höher installiert sein. Öffnen Sie zum Aktualisieren auf das neueste HoloLens-Release die App Einstellungen, navigieren Sie zu Update und Sicherheit, und wählen Sie dann Nach Updates suchen aus.
- Sie benötigen einen Windows-Computer, auf dem Visual Studio 2019 oder höher installiert ist. Ihre Visual Studio-Installation muss die Workload Entwicklung für die universelle Windows-Plattform und die Komponente Windows 10 SDK (10.0.18362.0 oder höher) enthalten. Sie müssen auch Git für Windows und Git LFS installieren.
- Unity muss installiert sein. Unterstützte Versionen und erforderliche Funktionen finden Sie auf der Setupseite für Unity-Projekte.
Erstellen einer Spatial Anchors-Ressource
Öffnen Sie das Azure-Portal.
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.
Herunterladen eines Beispielprojekts und Importieren des SDK
Klonen des Beispielrepositorys
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
Importieren des ASA SDK
Befolgen Sie diese Anweisungen, um die für die HoloLens-Plattform erforderlichen ASA SDK-Pakete herunterzuladen und zu importieren.
Konfigurieren von Unity
Öffnen Sie in Unity das Projekt im Ordner Unity. Unity weist Sie unter Umständen darauf hin, dass die Version im Projekt nicht mit der Version identisch ist, die Sie auf Ihrem Computer installiert haben. Diese Warnung ist in Ordnung, solange Ihre Version des Unity-Editors neuer ist als diejenige, mit der das Projekt erstellt wurde. Wenn Ihre Version neuer ist, wählen Sie Weiter aus. Wenn Ihre Version älter ist als die, die das Projekt benötigt, wählen Sie Beenden aus, und aktualisieren Sie Ihren Unity-Editor.
Wählen Sie Datei>Buildeinstellungen aus, um Buildeinstellungen zu öffnen.
Wählen Sie im Abschnitt Plattform die Option Universelle Windows-Plattform. Ändern Sie das Zielgerät zu HoloLens.
Wählen Sie Plattform wechseln, um die Plattform in Universelle Windows-Plattform zu ändern. Unity fordert Sie möglicherweise zur Installation fehlender unterstützender UWP-Komponenten auf.
Schließen Sie das Fenster Buildeinstellungen.
Konfigurieren der Kontoinformationen
Im nächsten Schritt wird die App zur Verwendung der Kontoinformationen konfiguriert. Sie haben die Werte für Kontoschlüssel, Konto-ID und Kontodomäne zuvor im Bereich Erstellen einer Spatial Anchors-Ressource in einen Text-Editor kopiert.
Navigieren Sie im Bereich Projekt zu Assets\AzureSpatialAnchors.SDK\Resources.
Wählen Sie SpatialAnchorConfig aus. Geben Sie im Bereich PrüfungAccount Key als Wert für den Spatial Anchors-Kontoschlüssel, Account ID als Wert für die Spatial Anchors-Konto-ID und Account Domain als Wert für die Spatial Anchors-Kontodomäne ein.
Exportieren des HoloLens-Visual Studio-Projekts
Wählen Sie Datei>Buildeinstellungen aus, um Buildeinstellungen zu öffnen.
Stellen Sie unter Scenes In Build (Szenen im Build) sicher, dass sich neben allen Szenen ein Häkchen befindet.
Wählen Sie Build aus. Wählen Sie im Dialogfeld einen Ordner aus, in den das HoloLens-Visual Studio-Projekt exportiert werden soll.
Nach Abschluss des Exports wird ein Ordner angezeigt, der das exportierte HoloLens-Projekt enthält.
Bereitstellen der HoloLens-Anwendung
Doppelklicken Sie im Ordner auf HelloAR U3D.sln, um das Projekt in Visual Studio zu öffnen.
Ändern Sie die Projektmappenkonfiguration zu Release und die Projektmappenplattform zu x86, und wählen Sie für das Bereitstellungsziel die Option Gerät aus.
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 per USB-Kabel eine Verbindung mit dem PC her.
Wählen Sie Debuggen>Debuggen starten, um Ihre App bereitzustellen und den Debugvorgang zu starten.
Wählen Sie in der App mithilfe der Pfeile BasicDemo aus, und klicken Sie dann auf die Schaltfläche Los, um die Demo zu starten. Befolgen Sie die Anleitung zum Anordnen und Abrufen eines Ankers.
Beenden Sie die App in Visual Studio, indem Sie entweder Debuggen beenden auswä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.