Schnellstart: Erstellen einer HoloLens-App mit Azure Object Anchors in Unity

In diesem Schnellstart erstellen Sie eine Unity HoloLens-App, die Azure Object Anchors verwendet. Azure Object Anchors ist ein verwalteter Clouddienst, der 3D-Ressourcen in KI-Modelle konvertiert, die objektbezogene Mixed Reality-Erlebnisse für HoloLens ermöglichen. Wenn Sie fertig sind, verfügen Sie über eine HoloLens-App, die mit Unity erstellt wurde und Objekte in der physischen Welt erkennen kann.

Sie lernen Folgendes:

• Vorbereiten von Unity-Buildeinstellungen
• Exportieren des HoloLens-Visual Studio-Projekts
• Bereitstellen und Ausführen der App auf einem HoloLens 2-Gerät.

Voraussetzungen

Stellen Sie für diese Schnellstartanleitung sicher, dass Sie über Folgendes verfügen:

• Ein physisches Objekt in Ihrer Umgebung und das zugehörige 3D-Modell (CAD oder gescannt)
• Einen Windows-Computer, auf dem folgende Komponenten installiert sind:
  • Git für Windows
  • 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)
  • Unity 2019.4
• Ein HoloLens 2-Gerät, das aktuell und für das der Entwicklermodus aktiviert ist.
  • Ö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.

Erstellen eines Object Anchors-Kontos

Zunächst müssen Sie ein Konto mit dem Object Anchors-Dienst erstellen.

1. Wechseln Sie zum Azure-Portal, und wählen Sie Ressource erstellen aus.

   

2. Suchen Sie nach der Object Anchors-Ressource.

   Suchen Sie nach „Object Anchors“.

   

   Wählen Sie in der Object Anchors-Ressource in den Suchergebnissen Erstellen > Object Anchors aus.

   

3. Führen Sie folgende Aktionen im Dialogfeld Object Anchors-Konto aus:

   • Geben Sie einen eindeutigen Ressourcennamen ein.
   • Wählen Sie das Abonnement aus, an das die Ressource angefügt werden soll.
   • Erstellen Sie eine Ressourcengruppe, oder verwenden Sie eine vorhandene.
   • Wählen Sie die Region aus, in der Sie die Ressource platzieren möchten.

   

   Wählen Sie Erstellen aus, um mit der Ressourcenerstellung zu beginnen.

4. Nachdem die Ressource erstellt wurde, wählen Sie zu Ressourcen wechseln aus.

   

5. Wechseln Sie zur Übersichtsseite:

   Notieren Sie sich die Kontodomäne. Sie benötigen die Information später.

   

   Notieren Sie sich die Konto-ID. Sie benötigen die Information später.

   

   Wechseln Sie zur Seite Zugriffsschlüssel, und notieren Sie sich den Primärschlüssel. Sie benötigen die Information später.

   

Einrichten des Geräts

Zum Bereitstellen von Apps für HoloLens müssen Sie Ihr HoloLens-Gerät erst mit Ihrem Computer koppeln.

1. Navigieren Sie auf Ihrem HoloLens-Gerät zu Settings -> Update & Security -> For Developers (Einstellungen -> Update & Sicherheit -> Für Entwickler).
2. Klicken Sie auf Pair (Koppeln), und lassen Sie den Bildschirm bis zur Eingabe der PIN bei Ihrer ersten Bereitstellung in Visual Studio geöffnet.

Hochladen des Modells

Bevor Sie die App ausführen, müssen Sie Ihre Modelle für die App verfügbar machen. Wenn Sie noch nicht über ein Object Anchors-Modell verfügen, befolgen Sie die Anweisungen unter Erstellen eines Modells, um eines zu erstellen. Kehren Sie dann hierher zurück.

Wenn Ihr HoloLens-Gerät eingeschaltet und mit dem Entwicklungsgerät (PC) verbunden ist, führen Sie die folgenden Schritte aus, um ein Modell in den Ordner 3D-Objekte auf Ihrem HoloLens-Gerät hochzuladen:

1. Wählen Sie die Modelle aus, die Sie verwenden möchten, und kopieren Sie sie, indem Sie STRG+C drücken.

2. Drücken Sie WINDOWS+E, um den Datei-Explorer zu starten. Ihr HoloLens-Gerät sollte mit anderen Laufwerken und Ordnern im linken Bereich aufgeführt werden.

   

3. Tippen Sie auf den HoloLens-Link, um den Speicher auf dem HoloLens-Gerät im rechten Bereich anzuzeigen.

   

4. Navigieren Sie im Datei-Explorer zu Interner Speicher > 3D-Objekte. Jetzt können Sie Ihre Modelle in den Ordner 3D-Objekte einfügen, indem Sie STRG+V drücken.

   

Öffnen des Beispielprojekts

Klonen Sie das Beispielrepository, indem Sie die folgenden Befehle ausführen:

git clone https://github.com/Azure/azure-object-anchors.git

cd ./azure-object-anchors

Der nächste Schritt besteht darin, das Azure Object Anchors-Paket für Unity herunterzuladen.

Download im Web

Suchen Sie hier nach dem Azure Object Anchors-Paket für Unity (com.microsoft.azure.object-anchors.runtime). Wählen Sie die gewünschte Version aus, und laden Sie das Paket über die Schaltfläche Download herunter.

Download mit npm

Für diesen Schritt ist erforderlich, dass npm installiert und verfügbar ist.

Führen Sie den folgenden Befehl aus. Ersetzen Sie dabei <version_number> durch die Version der Azure Object Anchors-Instanz, die Sie herunterladen möchten:

npm pack com.microsoft.azure.object-anchors.runtime@<version_number> --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/

Hinweis

Führen Sie zum Auflisten der verfügbaren Versionen des Azure Object Anchors-Pakets den folgenden Befehl aus:

npm view com.microsoft.azure.object-anchors.runtime --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/ versions

Das Azure Object Anchors-Paket wird in den Ordner heruntergeladen, in dem Sie den Befehl ausgeführt haben.

Mixed Reality-Featuretool (Betaversion)

Fahren Sie mit dem nächsten Schritt fort. Das Mixed Reality-Featuretool verwenden Sie in einem späteren Schritt.

Öffnen Sie das Projekt quickstarts/apps/unity/basic in Unity.

Download im Web

Befolgen Sie diese Anweisungen, um mithilfe von Unity Package Manager die Azure Object Anchors-Pakete zu importieren, die Sie in das Unity-Projekt heruntergeladen haben.

Download mit npm

Befolgen Sie diese Anweisungen, um mithilfe von Unity Package Manager die Azure Object Anchors-Pakete zu importieren, die Sie in das Unity-Projekt heruntergeladen haben.

Mixed Reality-Featuretool (Betaversion)

Für diesen Schritt ist erforderlich, dass das Mixed Reality-Featuretool heruntergeladen und verfügbar ist.

Hinweis

Das Mixed Reality-Featuretool unterstützt aktuell nur Windows.

1. In der Dokumentation zum Mixed Reality-Featuretool erfahren Sie, wie Sie das Tool einrichten und verwenden.
2. Installieren Sie das Featurepaket „Microsoft Azure Object Anchors“ im Unity-Projektordner.

Konfigurieren der Kontoinformationen

Im nächsten Schritt wird die App zur Verwendung der Kontoinformationen konfiguriert. Sie haben die Werte von Account Key (Kontoschlüssel), Account ID (Konto-ID) und Account Domain (Kontodomäne) im Abschnitt "Erstellen eines Object Anchors-Kontos" beachtet.

Navigieren Sie im Bereich Projekt zu Assets\AzureObjectAnchors.SDK\Resources.

Wählen Sie ObjectAnchorsConfig aus. Geben Sie im Bereich PrüfungAccount Key als Wert für den Object Anchors-Kontoschlüssel, Account ID als Wert für die Object Anchors-Konto-ID und Account Domain als Wert für die Object Anchors-Kontodomäne ein.

Erstellen und Ausführen der App

Erstellen der Beispielszene

Navigieren Sie im Unity-Editor zu Assets/MixedReality.AzureObjectAnchors/Scenes, öffnen Sie AOASampleScene, und fügen Sie das Element der Liste für die Szenenerstellung hinzu.

Wählen Sie Datei > Buildeinstellungen aus. Wählen Sie Universelle Windows-Plattform und dann Plattform wechseln aus. Wenn vom Unity-Editor gemeldet wird, dass Sie zunächst einige Komponenten herunterladen müssen, müssen Sie diese herunterladen und installieren. Folgen Sie dem Screenshot unten, um die Buildeinstellungen zu konfigurieren. Stellen Sie sicher, dass nur neben AOASampleScene ein Häkchen verfügbar ist. Alle anderen Szenen sollten nicht eingeschlossen werden.

Wählen Sie Build und dann einen Ausgabeordner aus. Sie können jetzt ein VS-Projekt im Ausgabeordner generieren.

Erstellen und Bereitstellen der App

Öffnen Sie die von Unity generierte .sln-Datei. Ändern Sie die Buildkonfiguration wie folgt.

Als Nächstes müssen Sie die IP-Adresse des Remotecomputers konfigurieren, um die App bereitzustellen und zu debuggen.

Klicken Sie mit der rechten Maustaste auf das App-Projekt, und klicken Sie anschließend auf Properties (Eigenschaften). Navigieren Sie auf der Eigenschaftenseite zu Configuration Properties -> Debugging (Konfigurationseigenschaften -> Debuggen). Ändern Sie den Wert für Machine Name (Computername) in die IP-Adresse Ihres HoloLens-Geräts, und klicken Sie auf Apply (Übernehmen).

Schließen Sie die Eigenschaftenseite. Klicken Sie auf Remote Machine (Remotecomputer). Die Erstellung und Bereitstellung der App auf Ihrem Remotegerät sollte nun beginnen. Stellen Sie sicher, dass Ihr Gerät aktiv ist.

Nach dem Unity-Begrüßungsbildschirm wird eine Meldung angezeigt, die besagt, dass Object Observer initialisiert wurde.

Die App sucht nach Objekten im aktuellen Feld der Ansicht und verfolgt sie nach der Erkennung nach. Eine Instanz wird entfernt, wenn sie sechs Meter vom Standort des Benutzers entfernt ist. Der Debugtext zeigt Details zu einer Instanz an, z. B. die ID, den aktualisierten Zeitstempel und die Oberflächenabdeckung.

Problembehandlung

Tipps

Wenn Ihr Objekt nicht erkannt wird, können Sie die folgenden Schritte ausprobieren:

1. Überprüfen Sie, ob Sie das richtige Modell für das Objekt verwenden.
2. Visualisieren Sie den Suchbereich, und stellen Sie sicher, dass er das Zielobjekt abdeckt.
3. Versuchen Sie, MinSurfaceCoverage zu verringern.
4. Klicken Sie im Windows-Geräteportal auf Views -> 3D Views (Ansichten > 3D-Ansichten), und vergewissern Sie sich, dass die Überprüfung beendet ist.

Nächste Schritte

Unity HoloLens mit MRTK

Konzepte: SDK-Übersicht

Häufig gestellte Fragen

Konvertierungs-SDK

Problembehandlung bei der Objekterkennung