Einrichten eines neuen OpenXR-Projekts ohne MRTK

Während Microsoft und die Community Open-Source-Tools wie das Mixed Reality Toolkit (MRTK) erstellt haben, das Ihre Umgebung automatisch für Mixed Reality einrichten wird, möchten einige Entwickler möglicherweise ihre Erfahrungen aus dem Boden erstellen.

Hinweis

Ab MRTK3 führen wir eine neue Mixed Reality-Designsprache für Entwickler ein. Weitere Informationen finden Sie in der MRTK3-Dokumentation.

Andere Nicht-OpenXR-Konfigurationsoptionen

Windows XR: Microsoft empfiehlt sich 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 Unity 2019 verwenden und AR Foundation 2.0 für die Kompatibilität mit ARCore/ARKit-Geräten benötigen, ermöglicht dieses Plug-In diese Unterstützung.

Wichtig

Die Verwendung dieses Plug-Ins in Unity 2019 ist nicht mit Azure Spatial Anchors kompatibel.

Legacy XR:

Wenn Sie sich noch auf Unity 2019 oder früher befinden, empfiehlt Microsoft die Verwendung der integrierten XR-Unterstützung für Legacy. Während das Windows XR-Plug-In auf Unity 2019 funktionsfähig ist, empfehlen wir es nicht, weil es nicht mit Azure Spatial Anchors auf Unity 2019 kompatibel ist.

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

Erstellen eines neuen Unity-Projekts

  1. Starten Sie den Unity Hub.

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

    Screenshot of Unity Hub in Projects tab with the New Project button highlighted.

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

    Screenshot of Unity Hub with the Editor version drop-down displayed.

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

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

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

    Screenshot of Unity Hub with 3D, Project Name, Location, and Create highlighted.

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

    Screenshot of your project open in Unity.

Achtung

Unter Windows gilt eine maximale Pfadlänge MAX_PATH von 255 Zeichen. Diese Einschränkung betrifft auch Unity, und es kann zu Fehlern beim Kompilieren kommen, wenn ein Dateipfad länger als 255 Zeichen ist. Daher wird empfohlen, dass Sie Ihr Unity-Projekt so nahe wie möglich am Stamm des Laufwerks speichern.

Festlegen des Buildziels

  1. Wählen Sie in der Menüleiste File>Build Settings... (Datei > Buildeinstellungen) aus.

    Um eine App für Windows Mixed Reality zu erstellen, müssen Sie ein Buildziel auswählen. Die Buildeinstellungen für die universelle Windows-Plattform (UWP) zielen auf jedes Gerät ab, einschließlich immersiver Headsets wie der HP Reverb G2. Dies ist die beste Wahl, wenn Sie für die HoloLens 2 erstellen; Wenn Sie sich jedoch auf Desktop-VR ausrichten, empfehlen wir Ihnen, den PC, Mac & Linux Standalone-Plattform zu verwenden.

  2. Führen Sie eines der folgenden Verfahren aus:

    Wenn Sie desktop VR ansprechen:

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

    Screenshot of Build Settings window open in the unity editor with PC, Mac & Standalone platform highlighted

    Wenn Sie auf holoLens 2 ausgerichtet sind:

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

    Zielgerät: HoloLens

    Architektur: ARM64

    Buildtyp: D3D-Projekt

    Ziel-SDK-Version: Letzte installierte Version

    Mindestens erforderliche Plattformversion: 10.0.10240.0

    Visual Studio-Version: Letzte installierte Version

    Erstellen und Ausführen auf: Lokaler Computer

    Buildkonfiguration: Release (Leistungsprobleme beim Debuggen bekannt)

    Screenshot of Build Settings window open in the unity editor with Universal Windows Platform highlighted.

  3. Klicken Sie auf die Schaltfläche Switch Platform (Plattform wechseln). In Unity wird eine Statusanzeige angezeigt, während die Plattform gewechselt wird.

  4. Schließen Sie das Fenster Buildeinstellungen nach Abschluss des Plattformwechsels.

Herunterladen und Installieren des Mixed Reality-Featuretools

Das Mixed Reality OpenXR-Plug-In kommt in Form eines Pakets für Unity. Die beste Möglichkeit zum Entdecken, Aktualisieren und Importieren von Featurepaketen ist das Mixed Reality Feature Tool. Sie können Pakete vor dem Importieren nach Name oder Kategorie durchsuchen, ihre Abhängigkeiten anzeigen und Änderungsvorschläge für Ihre Projektmanifestdatei anzeigen.

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

  2. Wenn der Download abgeschlossen ist, entpacken Sie die Datei, und speichern Sie sie auf Ihrem Desktop.

    Hinweis

    Bevor Sie das Mixed Reality Feature-Tool ausführen können, müssen Sie .NET 5.0 Runtime installieren.

  3. Navigieren Sie im entpackten Ordner zur ausführbaren Datei MixedRealityFeatureTool.exe, und verwenden Sie diese dann zum Starten des Mixed Reality Feature-Tools.

    Screenshot of Opening MixedRealityFeatureTool.

Importieren des Mixed Reality OpenXR-Plug-Ins

  1. Wählen Sie im Mixed Reality Feature-Tool Starten aus.

    Screenshot of the Mixed Reality Feature Tool opening screen.

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

    Open your project

    Hinweis

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

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

    Screenshot of the Mixed Reality feature Tool Project Path screen.

  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 entdecken eine Liste von sechs Paketgruppen angezeigt wird.

    The main groups of packages in the Mixed Reality Feature Tool

  5. Klicken Sie links von Plattformunterstützung (0 von 5) auf die Schaltfläche „+“, und wählen Sie dann die neueste Version des Mixed Reality OpenXR-Plug-Ins aus.

    Screenshot of package selections in the Mixed Reality Feature Tool.

  6. Nachdem Sie Ihre Auswahl vorgenommen haben, klicken Sie auf "Features abrufen".

  7. Wählen Sie "Überprüfen " aus, um das ausgewählte Paket zu überprüfen. Es sollte ein Dialogfeld mit der Meldung Keine Überprüfungsprobleme erkannt angezeigt werden. Klicken Sie anschließend auf OK.

  8. Auf der Seite "Features importieren " zeigt die linke Spalte "Features" das paket an, das 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.

  9. Wenn Sie bereit sind, zu wechseln, wählen Sie "Importieren" aus. Auf der Seite "Überprüfen und Genehmigen " können Sie Informationen zum Paket überprüfen.

  10. Wählen Sie Genehmigen aus.

  11. Kehren Sie zum Unity-Editor zurück, und klicken Sie auf der Benutzeroberfläche auf einen leeren Bereich. Sie sehen eine Statusleiste, die Ihnen zeigt, dass Ihr Paket importiert wird.

  12. Nachdem Unity das Paket importiert hat, wird eine Warnung angezeigt, die fragt, ob Sie die Back-Ends aktivieren möchten, indem Sie den Editor neu starten. Wählen Sie Ja aus.

    Screenshot of Unity Restart Option.

Konfigurieren des Projekts für Desktop-VR

Wenn Sie für die HoloLens2 entwickeln, überspringen Sie diesen Abschnitt, und wechseln Sie zum nächsten, konfigurieren Sie das Projekt für die HoloLens 2.

  1. Wählen Sie auf der Menüleiste dieOption "Projekteinstellungenbearbeiten>" aus.

  2. Stellen Sie im Fenster "Projekteinstellungen " sicher, dass Sie sich auf der XR-Plug-In-Verwaltungsseite und auf der Registerkarte "Mac & Linux Eigenständige " befinden.

    Screenshot of the Project Settings Window open to the XR Plugin Management Page and PC, Mac & Linux Standalone tab.

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

    Screenshot of the Project Settings Window, inside the PC, Mac & Linux Standalone tab, with Initialize XR on Startup selected and the OpenXR Plugin highlighted.

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

    Screenshot of Project Settings Window the OpenXR Plugin and Windows Mixed Reality feature group highlighted.

Beachten Sie, dass nun ein gelbes Warndreieck neben OpenXR angezeigt wird. Dies gibt an, dass Sie inkompatible Einstellungen haben, die aufgelöst werden müssen. Um herauszufinden, wie Sie dies beheben möchten, überspringen Sie den nächsten Abschnitt zum Konfigurieren der HoloLens 2, und fahren Sie mit dem folgenden Abschnitt fort, um die inkompatiblen Einstellungen zu beheben.

Konfigurieren des Projekts für holoLens 2

  1. Wählen Sie auf der Menüleiste dieOption "Projekteinstellungenbearbeiten>" aus.

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

    Screenshot of the Project Settings Window open to the XR Plugin Management Page and Universal Windows Platform tab.

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

    Screenshot of Project Settings Window, inside the Universal Windows Platform, with Initialize XR on Startup selected and the OpenXR Plugin highlighted.

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

    Screenshot of Project Settings Window with with the OpenXR plugin and the Microsoft HoloLens Feature Group highlighted.

Beachten Sie, dass neben OpenXR ein gelbes Warnungsdreieck vorhanden ist. Dies gibt an, dass Sie inkompatible Einstellungen haben, die aufgelöst werden müssen.

Auflösen von inkompatiblen Einstellungen

Die Bilder in diesem Abschnitt zeigen die Optionen auf der Registerkarte "Universelle Windows-Plattform". Die Anweisungen sind jedoch für die Desktop-VR-Registerkarte identisch, außer wo angegeben.

  1. Zeigen Sie den Cursor auf das gelbe Warnungsdreieck neben OpenXR, lesen Sie dann die Nachricht im Popup, und wählen Sie dann das Dreieck aus.

    Screenshot of warning about incompatible settings.

  2. Im Fenster OpenXR-Projektüberprüfung sind mehrere Probleme aufgeführt. Wählen Sie die Schaltfläche Alle korrigieren aus.

    Screenshot of the Fix All button in the OpenXR Project Validation window.

  3. Ein Problem bleibt bestehen und weist Sie darauf hin, 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.

    Screenshot of the Project Settings window with the OpenXR settings displayed.

  4. Beachten Sie die Schaltfläche mit dem Pluszeichen (+) unter Interaktionsprofile.

    Screenshot of the Add Interaction Profile button.

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

    Profil „Interaktionen per Eyetracking“

    Profil „Interaktionen per Hand“

    Profil „Microsoft Motion-Controller“

    Screenshot of interaction profiles that should be added.

    Wenn das Profil „Interaktionen per Eyetracking“ 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.

    Screenshot of the Fix button for the Eye Gaze interaction profile.

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

    Wenn Sie sich auf der Registerkarte Desktop VR befinden:

    Windows Mixed Reality

    Hand-Tracking

    Motion Controller-Modell

    Screenshot of the OpenXR Feature Groups for the Desktop VR tab.

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

    Microsoft HoloLens

    Hand-Tracking

    Motion Controller-Modell

    Screenshot of selected features for OpenXR.

  7. Klicken Sie auf die Dropdownliste Depth Submission Mode (Übermittlungsmodus Tiefe), und wählen Sie dann Depth 16 Bit (Tiefe 16 Bit) aus.

    Screenshot of Depth 16 Bit selected for Depth Submission Mode.

    Tipp

    Die Reduzierung der Formattiefe auf 16 Bit ist optional, kann jedoch die Grafikleistung Ihres Projekts verbessern. Weitere Informationen finden Sie unter Tiefenpufferfreigabe (HoloLens).

    Hinweis

    Die Einstellung Render Mode (Renderingmodus), die sich direkt über dem Depth Submission Mode (Übermittlungsmodus Tiefe) befindet, ist standardmäßig auf Single Pass Instanced (Einzeldurchgang, instanziiert) festgelegt. In Mixed Reality-Apps wird die Szene zweimal gerendert, einmal für jedes Auge. Das Ergebnis ist eine „stereoskopische Darstellung". Dies verdoppelt die Menge an erforderlichem Computing, daher ist es wichtig, den effizientesten Renderingpfad in Unity auszuwählen, um sowohl CPU- als auch GPU-Zeit zu sparen. Das Single Pass Instanced-Rendering ist hier die beste Wahl. Wir empfehlen, es standardmäßig für jedes Projekt zu aktivieren. Weitere Informationen hierzu finden Sie in der Unity-Dokumentation.

Konfigurieren der Spielereinstellungen

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

  2. Beachten Sie, dass im Fenster "Spieler " das Feld " Produktname " bereits ausgefüllt ist. Dies wird von Ihrem Projektnamen abgeleitet und wird der Name sein, der im HoloLens-Startmenü angezeigt wird.

    Screenshot of Unity Publishing Settings with the Project Name box filled in.

    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.

  3. Klicken Sie auf das Dropdownmenü " Veröffentlichungseinstellungen" , und geben Sie dann im Feld "Paketname " einen geeigneten Namen ein.

    Screenshot of Unity Publishing Settings with the package name box filled in.

    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.

  4. Schließen Sie das Fenster Project Settings (Projekteinstellungen).

Optimization (Optimierung)

Wenn Sie für HoloLens 2 entwickeln, übernehmen Sie auf der Menüleiste Mixed Reality > Project > empfohlene Projekteinstellungen für HoloLens 2 , um eine bessere App-Leistung zu erhalten.

Screenshot of the mixed reality menu item open with OpenXR selected

Sie sind jetzt bereit, mit OpenXR in Unity zu entwickeln!

Unity-Beispielprojekte

Schauen Sie sich das OpenXR Mixed Reality-Beispiel-Repo für Beispiel-Unity-Projekte an, die zeigen, wie Unity-Anwendungen für HoloLens 2 oder Mixed Reality-Headsets mithilfe des Mixed Reality OpenXR-Plug-Ins erstellt werden.

Weitere Informationen