Ersteinrichtung für MRTK3

Willkommen bei der öffentlichen Vorschau von MRTK3! Da MRTK3 eine Sammlung lose gekoppelter Pakete ist, wird MRTK3 anders verwendet als MRTK 2.x. Wir stellen MRTK nicht als Unity-Projekt zur Verfügung. Sie müssen also entweder unser Beispielprojekt verwenden, das so vorkonfiguriert ist, dass es alle MRTK-Pakete verwendet (was den Einstieg erleichtert), oder mit einem neuen Projekt beginnen (was Ihnen mehr Kontrolle gibt und empfohlen wird).

Es wird nicht erwartet, dass Sie jedes MRTK-Paket verwenden. Sehen Sie , welche Features für Sie nützlich sind und fügen Sie nur die Abhängigkeiten hinzu, die von Bedeutung sind.

Installieren der Tools

Stellen Sie sicher, dass Sie alle Tools in diesem Link haben, bevor Sie beginnen:

Hinweis

Informieren Sie sich über bekannte Probleme in bestimmten Unity-Versionen, bevor Sie sich für eine Unity-Version entscheiden.

Pfad 1: Klonen Sie das Repository und probieren Sie das Unity-Beispielprojekt aus

Der einfachste Weg, MRTK3 zu erwerben und auszuprobieren, ist mithilfe unseres vorkonfigurierten Projekts mit Referenzen zu allen aktuellen MRTK3-Paketen. Bitte klonen Sie unser Projekt in unserem GitHub Repository und prüfen Sie den mrtk3 Zweig. Danach können Sie einfach Unity (2020.3.33f1 oder neuer) auf dem MRTKDevTemplate Projekt unter UnityProjects starten und beginnen, mit den Beispielszenen im Editor mittels Remoting oder Bereitstellung auf Geräten zu spielen.

Informationen zu den Beispielszenen, die in der Vorschau enthalten sind, finden Sie unter Verwenden und Erstellen von Szenen.

Pfad 2: Hinzufügen von MRTK3 zu einem neuen Unity-Projekt

1. Erstellen Sie ein neues Unity-Projekt

Erstellen Sie ein neues Unity-Projekt mit Unity 2020.3.35f1 oder neuer / Unity 2021.3.4f1 oder neuer. Schließen Sie das Unity-Projekt, bevor Sie mit dem nächsten Schritt fortfahren.

2. Importieren Sie die erforderlichen Abhängigkeiten und MRTK3-Pakete mit dem Mixed Reality Feature-Tool

Es gibt eine Handvoll Pakete, die MRTK3 verwendet, welche nicht Teil dieser Vorschau sind. Um diese zu erhalten, verwenden Sie bitte die Mixed Reality Feature Tool und wählen Sie im Schritt "Features entdecken" die neuesten Versionen der folgenden Produkte aus:

  • Plattformunterstützung → Mixed Reality OpenXR-Plug-In
  • Räumliche Audiowiedergabe → Microsoft Spatializer (optional)

Für MRTK3-Pakete empfehlen wir dringend die beiden folgenden Pakete, um Ihnen den Einstieg zu erleichtern:

  • MRTK3 → MRTK-Eingabe (erforderlich für dieses Setup)
  • MRTK3 → MRTK UX-Komponenten

Diese beiden Pakete und deren (automatisch vom Featuretool hinzugefügte) Abhängigkeiten ermöglichen es Ihnen, die meisten unserer UX-Angebote zu erkunden und Projekte zu erstellen, die für verschiedene XR-Geräte bereitgestellt werden können. Sie können später immer wieder zum Featuretool zurückkehren und Ihrem Projekt weitere Pakete hinzufügen.

Hinweis

Weitere Informationen zu MRTK3-Paketen finden Sie auf der Seite Paketübersicht.

Wenn Sie mit dem Auswählen von Paketen fertig sind, klicken Sie auf Features abrufen und folgen Sie der Anleitung im Mixed Reality Feature-Tool, um die ausgewählten Pakete in Ihr Unity-Projekt zu importieren.

3. Öffnen Sie das Unity-Projekt

Öffnen Sie das Unity-Projekt, und warten Sie, bis Unity das Importieren der neu hinzugefügten Pakete abgeschlossen hat. Möglicherweise gibt es zwei Popups in diesem Prozess:

  1. Das erste Popup fragt, ob Sie das neue Eingabe-Back-End aktivieren möchten. Wählen Sie ja aus.
  2. Das zweite Popup fragt, ob Sie XR InteractionLayerMask aktualisieren möchten. Wählen Sie Nein danke aus.

Unity kann einige Mal während dieses Prozesses neu starten-- Warten Sie, bis es fertig ist, bevor Sie fortfahren.

4. MRTK-Profil nach dem Import konfigurieren

Nach dem Importieren erfordert MRTK3 ein Profil, das für eigenständige und jede zusätzliche Zielplattform festgelegt werden soll.

  1. Navigieren Sie zu Bearbeiten > Projekteinstellungen.

  2. Navigieren Sie unter Projekteinstellungen zu MRTK3, und wechseln Sie zur eigenständigen Registerkarte. Beachten Sie, dass das Profil zunächst nicht angegeben ist.

  3. Füllen Sie das Feld mit dem Standard-MRTK-Profil auf, das das Kernpaket enthält. Sie können im Schlüsselwort "MRTKprofile" in die Suchleiste des Projektfensters eingeben; stellen Sie sicher, dass Sie in All suchen. Alternativ finden Sie das Profil unter Packages/com.microsoft.mrtk.core/Configuration/Default Profiles/MRTKProfile.asset.

    Hinweis

    Nicht alle MRTK-Subsysteme werden unten im Screenshot angezeigt. Die MRTK-Subsysteme, die Sie sehen, können unterschiedlich sein, je nachdem, welche MRTK3-Pakete Sie zu Ihrem Projekt hinzugefügt haben.

    Zuweisen des MRTK-Standardprofils

  4. Wechseln Sie zu den Registerkarten der anderen Build-Ziele, die Sie verwenden möchten (z. B. UWP, Android) und prüfen Sie, um zu sehen, ob das Profil zugewiesen ist. Wenn nicht, wiederholen Sie den vorherigen Schritt auf der aktuellen Registerkarte.

Nach dem Import erfordert MRTK3 einige Konfigurationen auf OpenXR, wenn Sie auf ein XR-Gerät wie die HoloLens 2 oder Quest abzielen.

Hinweis

Die folgenden Anweisungen gelten für HoloLens 2 oder WMR-Headsets. Wenn Sie Quest einsetzen möchten, beachten Sie bitte die Anweisungen auf der Quest-Bereitstellungsseite.

  1. Navigieren Sie zu Bearbeiten > Projekteinstellungen.

  2. Navigieren Sie unter Projekteinstellungen zu XR Plug-In Management und aktivieren Sie OpenXR sowohl auf der eigenständigen als auch auf der UWP-Registerkarte. Stellen Sie auf jeder Registerkarte sicher, dass XR beim Start initialisieren ausgewählt ist und dass die Windows Mixed Reality Featuregruppe unter "Eigenständig" und die Microsoft HoloLens Featuregruppe unter UWP aktiviert sind.

    Hinweis

    Nach dem Aktivieren der Option OpenXR kann ein gelbes Warnsymbol erscheinen. Klicken Sie auf dieses Symbol, um das OpenXR-Projektüberprüfungstool zu öffnen. Klicken Sie auf Alle beheben, und ignorieren Sie das Problem des Interaktionsprofils, das nicht automatisch behoben werden kann. Die Profile werden im nächsten Schritt hinzugefügt.

    Für Einzelpersonen:

    Fenster für die XR-Plug-In-Verwaltung: Eigenständige Variante

    Für UWP:

    Fenster für die XR-Plug-In-Verwaltung: UWP-Variante

  3. Navigieren Sie unter Projekteinstellungen zu XR Plug-In Management >OpenXR> Interaktionsprofile und fügen Sie die folgenden drei Profile für UWP und Standalone (Eigenständig) hinzu:

    • Profil „Interaktionen per Eyetracking“
    • Profil „Interaktionen per Hand“
    • Profil „Microsoft Motion-Controller“

    Hinweis

    Möglicherweise müssen Sie das OpenXR-Projektüberprüfungstool verwenden, um das gelbe Dreieck zu beseitigen.

    Hinweis

    Möglicherweise müssen Sie das OpenXR-Projektüberprüfungstool verwenden, um das gelbe Dreieck zu beseitigen.

    Für Einzelpersonen:

    OpenXR (eigenständig)

    Für UWP:

    UWP-OpenXR

  4. Für HoloLens 2 empfehlen wir, den Tiefenübermittlungsmodus in den oben genannten Einstellungen auf 16-Bit festzulegen. Für immersive Headsets können Sie die 24-Bit-Tiefenübermittlung verwenden. Weitere Informationen finden Sie in den Microsoft-Entwicklungsdokumenten für Unity.

6. Herzlichen Glückwunsch, die Projekteinrichtung ist jetzt fertig!

Bitte fahren Sie mit der Erstellung einer neuen MRTK3-Szene fort.

Nächste Schritte