Übung: Importieren und Konfigurieren von Ressourcen
Installieren des Mixed Reality Feature Tools
Um das Mixed Reality-Toolkit in Ihr Projekt zu importieren, verwenden Sie das Mixed Reality-Featuretool. Mit dem Mixed Reality Feature-Tool können Entwickelnde Featurepakete ermitteln, aktualisieren und importieren. Sie können Pakete vor dem Importieren nach Name oder Kategorie durchsuchen, ihre Abhängigkeiten anzeigen und Änderungsvorschläge für Ihre Projektmanifestdatei anzeigen.
Laden Sie die neueste Version des Mixed Reality-Featuretools aus dem Microsoft Download Center herunter.
Wenn der Download beendet ist, öffnen Sie die Datei MixedRealityFeatureTool.exe, um das Mixed Reality Feature-Tool zu starten.
Hinweis
Bevor Sie das Mixed Reality-Featuretool ausführen können, müssen Sie möglicherweise die .NET 6.0-Runtime installieren.
Importieren des MRTK-Basispakets für Unity
Wählen Sie im Mixed Reality Feature-Tool Starten aus.
Wählen Sie die Schaltfläche Durchsuchen aus (in der folgenden Abbildung ist dies die Schaltfläche mit den drei Punkten), navigieren Sie zu Ihrem Projekt, und öffnen Sie es.
Nachdem Sie einen Ordner ausgewählt haben, überprüft das Tool, ob es sich um einen gültigen Unity-Projektordner handelt.
Wählen Sie Features entdecken aus.
Hinweis
Möglicherweise müssen Sie einige Sekunden warten, während das Tool die Pakete aus den Feeds aktualisiert.
Beachten Sie, dass auf der Seite Features entdecken eine Liste der verfügbaren Paketgruppen angezeigt wird.
Wählen Sie links neben Plattformunterstützung (0 von 5) die Schaltfläche + und dann die aktuelle Version des Mixed Reality OpenXR-Plug-Ins aus.
Wählen Sie die Schaltfläche Alles auswählen rechts neben MRTK3 aus, damit alle Features ausgewählt werden.
Hinweis
Wenn Sie Pakete sehen, die als veraltet markiert sind, sollten Sie diese entfernen und sicherstellen, dass Einstellungen > Feature > Veraltete Pakete anzeigen ausgewählt ist.
Nachdem Sie Ihre Auswahl getroffen haben, wählen Sie Get Features (Features abrufen) aus.
Wählen Sie Überprüfen aus, um die ausgewählten Pakete zu überprüfen. Es sollte ein Dialogfeld mit der Meldung Keine Überprüfungsprobleme erkannt angezeigt werden. Wählen Sie OK aus.
Auf der Seite Import Features (Features importieren) werden in der linken Spalte Features die von Ihnen ausgewählten Pakete angezeigt. In der rechten Spalte Erforderliche Abhängigkeiten werden alle Abhängigkeiten angezeigt. Sie können für jedes dieser Elemente den Link Details auswählen, um mehr darüber zu erfahren.
Wenn Sie bereit sind fortzufahren, wählen Sie Importieren aus. Auf der Seite Überprüfen und genehmigen können Sie die Informationen zu den Paketen überprüfen.
Wählen Sie Genehmigen aus.
Wählen Sie Beenden aus.
Kehren Sie zum Unity-Editor zurück, und wählen Sie einen leeren Bereich auf der Benutzeroberfläche aus. Es wird eine Statusleiste für den Import Ihrer Pakete angezeigt.
Konfigurieren des Unity-Projekts
Nachdem Unity die Pakete importiert hat, wird eine Warnung angezeigt, in der Sie gefragt werden, ob Sie die Back-Ends aktivieren möchten, indem Sie den Editor neu starten. Wählen Sie Ja aus.
Unity fragt in XR InteractionLayerMask, ob Methoden aktualisiert werden sollen. Wählen Sie Ich habe eine Sicherung erstellt. Los geht‘s! aus, und warten Sie, bis Unity neu gestartet wurde.
Wählen Sie in der Menüleiste Mixed Reality>Projekt>Empfohlene Projekteinstellungen für HoloLens anwenden aus.
Wählen Sie in der Menüleiste Bearbeiten>Projekteinstellungen... und dann XR-Plug-In-Verwaltung aus. Stellen Sie sicher, dass XR beim Start initialisieren ausgewählt ist, und wählen Sie dann unter Plug-In-Anbieter die Option OpenXR aus.
Das OpenXR-Plug-In wird geladen, und dann werden unter OpenXR zwei Elemente angezeigt. Wählen Sie das erste Element aus: Microsoft HoloLens-Featuregruppe. Wählen Sie das gelbe Ausrufezeichen aus.
Wählen Sie Alle korrigieren aus.
Einige Warnungen bleiben bestehen. Ignorieren Sie dies vorerst.
Wählen Sie unter XR-Plug-In-Verwaltung die Option OpenXR aus.
Fügen Sie unter Interaktionsprofile die Profile Microsoft-Handinteraktionen und Profil „Interaktionen per Eyetracking“ hinzu, wenn diese nicht bereits hinzugefügt wurden.
Stellen Sie sicher, dass auf der linken Seite Microsoft HoloLens und auf der rechten Seite Hand-Tracking, Mixed Reality-Features und Motion-Controller-Modell ausgewählt sind.
Wählen Sie das Warnzeichen neben Profil „Interaktionen per Eyetracking“ aus, um das Fenster Projektüberprüfung wieder aufzurufen. Stellen Sie sicher, dass Sie sich auf der Registerkarte UWP-Plattform befinden (auf der Registerkarte ist das Windows-Logo zu sehen), und wählen Sie Alle korrigieren aus, um die Probleme bei der Überprüfung zu beheben. Beachten Sie, dass auch nach der Auswahl von Alle korrigieren einige Probleme verbleiben können. Wählen Sie in diesem Fall erneut Alle korrigieren aus, ignorieren Sie alle Probleme, die als Szenenspezifisch gekennzeichnet sind. Lesen Sie dann die Empfehlungen für die verbleibenden Probleme (falls vorhanden), und nehmen Sie die gewünschten Änderungen vor.
Wählen Sie unter Projekteinstellungen die Option MRTK3 aus, und überprüfen Sie, ob ein gültiges Profil vorhanden ist. Wenn keins vorhanden ist, suchen Sie in den Paketen des Projekts (Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset) nach MRTKProfile, und weisen Sie es als Profil zu.
Konfigurieren von Projekteinstellungen
Wählen Sie in der Menüleiste Bearbeiten>Projekteinstellungen aus.
Wählen Sie in der linken Spalte des Fensters Project Settings (Projekteinstellungen) die Option Player aus.
Beachten Sie, dass im Player-Fenster „MRTK Tutorial“ als Produktname angezeigt wird. Dieser Name wird aus Ihren Projektnamen übernommen und ist der im HoloLens Startmenü angezeigte Name.
Tipp
Fügen Sie vor dem Namen der App einen Unterstrich hinzu, damit sie am Anfang einer Liste angezeigt wird und so während der Entwicklung leichter zu finden ist.
Wählen Sie das Dropdownmenü Veröffentlichungseinstellungen aus, und geben Sie dann im Feld Paketname einen geeigneten Namen ein, z. B. MRTK-Tutorials-Getting-Started:
Hinweis
Der Paketname stellt den eindeutigen Bezeichner für die App dar. Wenn Sie vermeiden möchten, dass zuvor installierte Versionen der App mit demselben Namen überschrieben werden, sollten Sie diesen Bezeichner vor der Bereitstellung der App ändern.
Schließen Sie das Fenster Project Settings (Projekteinstellungen).
Erstellen der Szene und Konfigurieren des MRTK
Wählen Sie in der Menüleiste File>New Scene (Datei > Neue Szene) aus. Wählen Sie die Option Einfach (Integriert) und dann Erstellen aus.
Navigieren Sie im Projektfenster zum Ordner Packages>MRTK Input>Assets>Prefabs. Ziehen Sie das Prefab MRTK XR Rig in die Szenenhierarchie.
Entfernen Sie das Spielobjekt der Hauptkamera, da das MRTK XR Rig-Spielobjekt bereits eine Kamera enthält.
Fügen Sie das Prefab MRTK Input Simulator (MRTK-Eingabesimulator) (Packages>MRTK Input>Simulation>Prefabs) zu Ihrer Szene hinzu.
Hinweis
Dieser Schritt ist optional, aber für In-Editor-Simulationen erforderlich.
Wählen Sie in der Menüleiste File>Save As... (Datei > Speichern unter) aus.
Navigieren Sie zum Ordner Assets>Scenes (Ressourcen > Szenen), benennen Sie Ihr Projekt, und speichern Sie es dann.