Einrichten eines neuen OpenXR-Projekts mit MRTK

Die einfachste Möglichkeit, Ihr Unity-Projekt für Mixed Reality einzurichten, ist das Mixed Reality Toolkit (MRTK). MRTK für Unity ist ein plattformübergreifendes Open-Source-Development Kit, das das Erstellen erstaunlicher Mixed Reality-Anwendungen vereinfacht.

MRTK bietet ein plattformübergreifendes Eingabesystem, grundlegende Komponenten und gemeinsame Bausteine für räumliche Interaktionen. Es kann Ihnen helfen, Ihre Anwendungsentwicklung für Microsoft HoloLens, Windows Mixed Reality immersive (VR)-Headsets und viele andere VR/AR-Geräte zu beschleunigen. Das Projekt zielt darauf ab, Eintrittsbarrieren zu reduzieren, sodass jeder Mixed Reality-Anwendungen erstellen und sich zurück zur Community beitragen kann, während wir alle wachsen.

MRTK unterstützt eine Vielzahl von Plattformen, einschließlich:

• Microsoft HoloLens

• Microsoft HoloLens 2

• Windows Mixed Reality Headsets

• OpenVR-Headsets (HTC Vive / Oculus Rift)

• Ultraleap Hand Tracking

• Android- und iOS-Geräte

Hinweis

Wir haben vor kurzem MRTK3 eingeführt, die dritte Generation von Microsoft Mixed Reality Toolkit für Unity, die auf dem XR Management System und XR Interaction Toolkit von Unity basiert, mit besserer Unterstützung für eine Vielzahl von OpenXR-kompatiblen Geräten und einer neuen Designsprache. Weitere Informationen finden Sie in der MRTK3-Dokumentation.

Hinweis

Sie können auch ein neues OpenXR-Projekt ohne MRTK einrichten.

Andere Nicht-OpenXR-Konfigurationsoptionen, die in Betracht gezogen werden sollten

Windows XR: Microsoft empfiehlt nicht, das Windows XR-Plug-In für neue Projekte in Unity 2020 zu verwenden. Stattdessen sollten Sie das Mixed Reality OpenXR-Plug-In verwenden. Wenn Sie jedoch Unity 2019 verwenden und AR Foundation 2.0 zur Kompatibilität mit ARCore/ARKit-Geräten benötigen, aktiviert dieses Plug-In diese Unterstützung.

Legacy-XR:

Wenn Sie noch Unity 2019 oder früher verwenden, empfiehlt Microsoft die Verwendung der Legacy Built-in XR-Unterstützung.

Wenn Sie ein neues Projekt starten, empfiehlt es sich, stattdessen Unity 2020 zu installieren und das Mixed Reality OpenXR-Plug-In zu verwenden.

Erste Schritte mit OpenXR: Erstellen eines neuen Unity-Projekts

1. Starten Sie den Unity-Hub.

2. Klicken Sie auf der Registerkarte Projekte auf Neues Projekt.

   

3. Klicken Sie unter Neues Projekt auf die Dropdownliste, und wählen Sie dann die gewünschte Editor Version aus.

   

4. Stellen Sie sicher, dass die ausgewählte Vorlage 3D Core ist.

5. Geben Sie im Feld Projektname einen Namen für Ihr Projekt ein, z. B. "MRTK-Tutorial".

6. Klicken Sie im Feld Speicherort auf das Ordnersymbol, navigieren Sie dann zu dem Ordner, in dem Sie Ihr Projekt speichern möchten, und wählen Sie ihn aus. Sie können auch einen neuen Ordner erstellen.

   

7. Klicken Sie auf Projekt erstellen. Dadurch wird Ihr Projekt in Unity geöffnet.

   

Achtung

Bei der Arbeit unter Windows gilt ein MAX_PATH Limit von 255 Zeichen. Unity ist von diesen Grenzwerten betroffen und kann möglicherweise nicht kompiliert werden, wenn ein Dateipfad länger als 255 Zeichen ist. Daher wird empfohlen, Ihr Unity-Projekt so nah wie möglich am Stamm des Laufwerks zu speichern.

Festlegen des Buildziels

1. Wählen Sie auf der MenüleisteDateibuildeinstellungen>... aus.

   Um eine App für Windows Mixed Reality zu erstellen, müssen Sie ein Buildziel auswählen. Die Buildeinstellungen für Universelle Windows-Plattform (UWP) sind auf jedes Gerät ausgerichtet, einschließlich immersiver Headsets wie dem HP Reverb G2. Dies ist die beste Wahl, wenn Sie für die HoloLens 2 erstellen. Wenn Sie jedoch Desktop-VR als Ziel haben, empfehlen wir Ihnen, den PC, Mac & eigenständige Linux-Plattform zu verwenden.

2. Führen Sie einen der folgenden Schritte aus:

   Wenn Sie Desktop VR als Ziel verwenden:

   • Behalten Sie den PC, Mac & eigenständige Linux-Plattform bei, die in einem neuen Unity-Projekt standardmäßig ausgewählt ist:

   

   Wenn Sie die HoloLens 2 als Ziel verwenden:

   • Wählen Sie unter Plattformdie Option Universelle Windows-Plattform aus. Stellen Sie sicher, dass die folgenden Einstellungen aktiv sind:

   Buildtyp: D3D-Projekt

   Ziel-SDK-Version: Zuletzt installiert

   Mindestplattformversion: 10.0.10240.0

   Visual Studio-Version: Zuletzt installiert

   

3. Klicken Sie auf die Schaltfläche Plattform wechseln . Unity zeigt eine Statusanzeige an, während die Plattform wechselt.

4. Nachdem der Plattformwechselvorgang abgeschlossen ist, schließen Sie das Fenster Buildeinstellungen .

Herunterladen und Installieren des Mixed Reality-Featuretools

Das Mixed Reality OpenXR-Plug-In wird in Form eines Pakets für Unity bereitgestellt. Die beste Möglichkeit zum Ermitteln, Aktualisieren und Importieren von Featurepaketen ist das Mixed Reality Featuretool. Sie können Pakete nach Namen oder Kategorie durchsuchen, ihre Abhängigkeiten anzeigen und vorgeschlagene Änderungen an der Manifestdatei Ihres Projekts anzeigen, bevor Sie sie importieren.

1. Laden Sie die neueste Version des Mixed Reality-Featuretools aus dem Microsoft Download Center herunter.

2. Navigieren Sie nach Abschluss des Downloads zur ausführbaren Datei MixedRealityFeatureTool.exe, und verwenden Sie sie dann, um das Mixed Reality FeatureTool zu starten.

   

Importieren der Mixed Reality Toolkit- und OpenXR-Pakete

1. Wählen Sie im Mixed Reality Featuretool die Option Start aus.

   

2. Wählen Sie die Schaltfläche Durchsuchen aus (dies ist die Schaltfläche "Drei Punkte" in der Abbildung unten), navigieren Sie dann zu Ihrem Projekt, und öffnen Sie es dann.

   

   Hinweis

   Das Feld Projektpfad im Tool muss einen Wert enthalten, daher wird standardmäßig ein umgekehrter Schrägstrich ("_") eingefügt.

   Nachdem Sie einen Ordner ausgewählt haben, überprüft das Tool, ob es sich um einen gültigen Unity-Projektordner handelt.

   

3. 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.

4. Beachten Sie, dass auf der Seite Features ermitteln eine Liste mit sechs Paketgruppen vorhanden ist.

   

5. Klicken Sie links neben Mixed Reality Toolkit (0 von 10) auf die Schaltfläche "+", und wählen Sie dann die neueste Version von Mixed Reality Toolkit Foundation aus.

   Hinweis

   Das Mixed Reality Toolkit Foundation-Paket ist das einzige Paket, das importiert und konfiguriert werden muss, um MRTK mit Ihrem Projekt verwenden zu können. Dieses Paket enthält die Kernkomponenten, die zum Erstellen einer Mixed Reality-Anwendung erforderlich sind.

6. Klicken Sie links neben Platform Support (0 von 5) auf die Schaltfläche "+", und wählen Sie dann die neueste Version von Mixed Reality OpenXR-Plug-In aus.

   

7. Nachdem Sie Ihre Auswahl getroffen haben, klicken Sie auf Features abrufen.

8. Wählen Sie Überprüfen aus, um die ausgewählten Pakete zu überprüfen. Es sollte ein Dialogfeld mit dem Hinweis Angezeigt werden, dass keine Validierungsprobleme erkannt wurden. Klicken Sie anschließend auf OK.

9. Auf der Seite Features importieren werden in der linken Spalte Features die Pakete angezeigt, die Sie gerade ausgewählt haben. In der rechten Spalte Erforderliche Abhängigkeiten werden alle Abhängigkeiten angezeigt. Sie können für jedes dieser Elemente auf den Link Details klicken, um mehr darüber zu erfahren.

10. Wenn Sie fortfahren möchten, wählen Sie Importieren aus. Auf der Seite Überprüfen und Genehmigen können Sie Informationen zu den Paketen überprüfen.

11. Wählen Sie Genehmigen aus.

12. Kehren Sie zum Unity-Editor zurück, und klicken Sie auf einen leeren Bereich in der Benutzeroberfläche. Es wird eine Statusanzeige angezeigt, die anzeigt, dass Ihre Pakete importiert werden.

Konfigurieren von Eingabe-Back-End-Einstellungen

1. Nachdem Unity das Paket importiert hat, wird eine Warnung mit der Frage angezeigt, ob Sie die Back-Ends durch neustarten des Editors aktivieren möchten. Wählen Sie Ja.

   

Konfigurieren sie das Projekt für die HoloLens 2 über die Projektvalidierung (MR OpenXR 1.6 und höher)

Wenn Sie für Desktop-VR entwickeln, überspringen Sie diesen Abschnitt, und wechseln Sie zu Konfigurieren des Projekts für Desktop-VR.

1. Klicken Sie auf der Menüleiste auf Mixed Reality > Projektvalidierungseinstellungen > HoloLens 2 Anwendung (UWP), um die Validierungsregeln für HoloLens 2 zu aktivieren. Für MR OpenXR-Plug-Ins vor Version 1.9 ist das verfügbare Menüelement Mixed Reality > Projekt > Empfohlene Projekteinstellungen für HoloLens 2 anwenden.
2. Vergewissern Sie sich im eingeblendeten Fenster für die Projektüberprüfung, dass Sie sich auf der Registerkarte UWP-Plattform befinden (durch das Windows-Logo gekennzeichnet), und klicken Sie auf Alle korrigieren , um die Validierungsprobleme zu beheben. Beachten Sie, dass nach dem Klicken auf Alle beheben probleme auftreten können. Klicken Sie in diesem Fall erneut auf Alle beheben , ignorieren Sie alle Probleme, die als "szenenspezifisch" (falls vorhanden) gekennzeichnet sind, und gehen Sie die restlichen Probleme (falls vorhanden) durch, um zu überprüfen, ob vorgeschlagene Änderungen vorhanden sind, die Sie vornehmen möchten.
3. Das Projekt ist an diesem Punkt fast bereit für HoloLens 2 Bereitstellung. Fahren Sie mit Konfigurieren der Spielereinstellungen für den nächsten Schritt fort.

Manuelles Konfigurieren des Projekts für die HoloLens 2

Wenn Sie für Desktop-VR entwickeln, überspringen Sie diesen Abschnitt, und wechseln Sie zu Konfigurieren des Projekts für Desktop-VR.

1. Stellen Sie sicher, dass das Fenster Projekteinstellungen geöffnet ist. Wenn nicht, wählen Sie auf der MenüleisteProjekteinstellungenbearbeiten> aus.

2. Stellen Sie im Fenster Projekteinstellungen sicher, dass Sie sich auf der Seite XR-Plug-In-Verwaltung und auf der Registerkarte Universelle Windows-Plattform befinden.

   

3. Stellen Sie sicher, dass XR beim Start initialisieren ausgewählt ist, und klicken Sie dann unter Plug-In-Anbieter auf ÖffnenXR.

   

4. Das OpenXR-Plug-In wird geladen, und unter OpenXR werden dann mehrere Elemente angezeigt. Wählen Sie Microsoft HoloLens Featuregruppe aus.

   

Beachten Sie, dass sich neben OpenXR ein gelbes Warndreieck befindet. Dies weist darauf hin, dass Sie über inkompatible Einstellungen verfügen, die aufgelöst werden müssen. Um herauszufinden, wie Sie dies beheben können, überspringen Sie den nächsten Abschnitt zum Konfigurieren für VR, und fahren Sie mit dem folgenden Abschnitt Auflösen inkompatibler Einstellungen fort.

Konfigurieren des Projekts für Desktop-VR per Projektvalidierung (MR OpenXR 1.9 und höher)

1. Klicken Sie auf der Menüleiste auf Mixed Reality > Projektvalidierungseinstellungen > Win32-Anwendung (eigenständig), um die Überprüfungsregeln für eine Desktop-XR-App zu aktivieren.
2. Stellen Sie im eingeblendeten Fenster für die Projektüberprüfung sicher, dass Sie sich auf der Registerkarte Eigenständige Plattform befinden, und klicken Sie auf Alle beheben , um die Validierungsprobleme zu beheben. Beachten Sie, dass nach dem Klicken auf Alle beheben probleme auftreten können. Klicken Sie in diesem Fall erneut auf Alle beheben , ignorieren Sie alle Probleme, die als "szenenspezifisch" (falls vorhanden) gekennzeichnet sind, und gehen Sie die restlichen Probleme (falls vorhanden) durch, um zu überprüfen, ob vorgeschlagene Änderungen vorhanden sind, die Sie vornehmen möchten.

Manuelles Konfigurieren des Projekts für Desktop-VR

1. Stellen Sie sicher, dass das Fenster Projekteinstellungen geöffnet ist. Wenn nicht, wechseln Sie zur Menüleiste, und wählen SieProjekteinstellungenbearbeiten> aus.

2. Vergewissern Sie sich im Fenster Projekteinstellungen , dass Sie sich auf der Seite XR-Plug-In-Verwaltung und auf der Registerkarte PC, Mac & Eigenständiger Linux-Computer befinden.

   

3. Stellen Sie sicher, dass XR beim Start initialisieren ausgewählt ist, und klicken Sie dann unter Plug-In-Anbieter auf ÖffnenXR.

   

4. Das OpenXR-Plug-In wird geladen, und dann werden zwei Elemente unter OpenXR angezeigt. Wählen Sie die erste Windows Mixed Reality Featuregruppe aus.

   

Beachten Sie, dass sich neben OpenXR jetzt ein gelbes Warndreieck befindet. Dies weist darauf hin, dass Sie über inkompatible Einstellungen verfügen, die aufgelöst werden müssen. Fahren Sie mit dem nächsten Abschnitt Auflösen inkompatibler Einstellungen fort, um herauszufinden, wie Sie dies beheben können.

Auflösen von inkompatiblen Einstellungen

Wichtig

Die Bilder in diesem Abschnitt zeigen die Optionen auf der Registerkarte Universelle Windows-Plattform. Die Anweisungen sind jedoch für die Registerkarte Desktop VR identisch, sofern nicht angegeben.

1. Zeigen Sie mit dem Cursor auf das gelbe Warndreieck neben OpenXR, lesen Sie dann die Meldung im Popup, und wählen Sie dann das Dreieck aus.

   

2. Im Fenster OpenXR-Projektüberprüfung sind mehrere Probleme aufgeführt. Wählen Sie die Schaltfläche Alle korrigieren aus. HINWEIS: Diese Liste kann je nachdem, auf welcher Registerkarte Sie sich befinden, unterschiedlich aussehen.

   

3. Ein Problem bleibt bestehen und teilt Ihnen mit, dass Sie mindestens ein Interaktionsprofil hinzufügen müssen. Klicken Sie dazu auf Bearbeiten. Dadurch gelangen Sie zu den Einstellungen für das OpenXR-Plug-In im Fenster Projekteinstellungen .

   

4. Notieren Sie sich unterhalb von Interaktionsprofilen das Pluszeichen (+).

   

5. Klicken Sie dreimal auf die Schaltfläche, und wählen Sie jedes Mal ein anderes Profil aus:

   Interaktionsprofil für augenvisieren

   Microsoft-Handinteraktionsprofil

   Microsoft Motion Controller-Profil

   

   Wenn das Interaktionsprofil für das Anvisieren von Augen oder ein anderes Profil mit einem gelben Dreieck daneben angezeigt wird, wählen Sie das Dreieck aus, und klicken Sie dann im Fenster OpenXR-Projektüberprüfung auf die Schaltfläche Korrigieren . Wenn Sie fertig sind, schließen Sie das Fenster OpenXR-Projektüberprüfung .

   

6. Stellen Sie im Fenster Projekteinstellungen unter OpenXR-Featuregruppen sicher, dass Folgendes ausgewählt ist:

   Wenn Sie sich auf der Registerkarte Desktop VR befinden:

   Windows Mixed Reality

   Handtracking

   Motion Controller-Modell

   

   Wenn Sie sich auf der Registerkarte Universelle Windows-Plattform befinden:

   Microsoft HoloLens

   Handtracking

   Motion Controller-Modell

   

7. Klicken Sie auf die Dropdownliste Tiefenübermittlungsmodus , und wählen Sie dann Tiefe 16 Bit aus.

   

   Tipp

   Das Reduzieren des Tiefenformats auf 16-Bit ist optional, kann jedoch die Grafikleistung in Ihrem Projekt verbessern. Weitere Informationen finden Sie unter Tiefenpufferfreigabe (HoloLens).

   Hinweis

   Die Einstellung Rendermodus , die sich direkt über dem Tiefenübermittlungsmodus befindet, ist standardmäßig auf Single Pass Instanced festgelegt. In Mixed Reality-Apps wird die Szene zweimal gerendert: einmal für jedes Auge. Das Ergebnis ist "stereoskopisches Sehen". Dadurch verdoppelt sich der erforderliche Computeaufwand. Daher ist es wichtig, den effizientesten Renderingpfad in Unity auszuwählen, um sowohl CPU- als auch GPU-Zeit zu sparen. Single Pass Instanced Rendering ist hier die beste Wahl. Es wird empfohlen, es standardmäßig für jedes Projekt zu aktivieren. Weitere Informationen hierzu finden Sie in der Unity-Dokumentation.

Konfigurieren von Player-Einstellungen

1. Wählen Sie in der linken Spalte des Fensters Projekteinstellungen die Option Player aus.

2. Beachten Sie, dass im Player-Fenster das Feld Produktname bereits ausgefüllt ist. Dies stammt aus Ihrem Projektnamen und ist der Name, der im HoloLens-Startmenü angezeigt wird.

   

   Tipp

   Damit die App während der Entwicklung leichter gefunden werden kann, fügen Sie einen Unterstrich vor dem Namen hinzu, um sie am Anfang einer Liste zu sortieren.

3. Klicken Sie auf die Dropdownliste Veröffentlichungseinstellungen , und geben Sie dann im Feld Paketname einen geeigneten Namen ein.

   

   Hinweis

   Der Paketname ist der eindeutige Bezeichner für die App. Wenn Sie das Überschreiben zuvor installierter Versionen der App mit demselben Namen vermeiden möchten, sollten Sie diesen Bezeichner vor der Bereitstellung der App ändern.

4. Schließen Sie das Fenster Projekteinstellungen .

Sie können nun mit der Entwicklung mit OpenXR in Unity beginnen!

Unity-Beispielprojekte

Sehen Sie sich das OpenXR Mixed Reality-Beispielrepository für Unity-Beispielprojekte an, in denen gezeigt wird, wie Unity-Anwendungen für HoloLens 2 oder Mixed Reality Headsets mithilfe des Mixed Reality OpenXR-Plug-Ins erstellt werden.

Siehe auch

• Einrichten eines neuen OpenXR-Projekts ohne MRTK
• Hinzufügen des Mixed Reality OpenXR-Plug-Ins zu Ihrem vorhandenen Unity-Projekt