Freigeben über

MRTK-Pakete — MRTK2

  • Artikel

Mixed Reality Toolkit (MRTK) ist eine Sammlung von Paketen, die die plattformübergreifende Mixed Reality-Anwendungsentwicklung ermöglichen, indem Unterstützung für Mixed Reality-Hardware und -Plattformen bereitgestellt wird.

MRTK ist als Asset-Pakete (Unitypackage) und über die Unity-Paket-Manager verfügbar.

Bestandspakete

Die MRTK-Ressource (Unitypackage) kann von GitHub heruntergeladen werden.

Zu den Vorteilen der Verwendung von Bestandspaketen gehören:

  • Verfügbar für Unity 2018.4 und höher
  • Einfaches Vornehmen von Änderungen an MRTK
    • MRTK befindet sich im Ordner "Assets"

Beispiele hierfür sind:

  • MRTK ist Teil des Projektordners "Assets" und führt zu
    • Größere Projekte
    • Langsamere Kompilierungszeiten
  • Keine Abhängigkeitsverwaltung
    • Kunden müssen Paketabhängigkeiten manuell auflösen
  • Manueller Updateprozess
    • Mehrere -Schritte
    • Große (3000+ Datei)-Quellcodeverwaltungsupdates
    • Risiko des Verlusts von Änderungen, die an MRTK vorgenommen wurden
  • Das Importieren des Beispielpakets bedeutet in der Regel, dass alle Beispiele eingeschlossen werden

Die verfügbaren Pakete sind:

Diese Pakete werden von Microsoft aus dem Quellcode auf GitHub veröffentlicht und unterstützt.

Foundation-Paket

Die Mixed Reality Toolkit Foundation ist der Satz von Code, mit dem Ihre Anwendung allgemeine Funktionen auf Mixed Reality-Plattformen nutzen kann.

Pakage Stiftung MRTK Foundation-Paket

Das MRTK Foundation-Paket enthält Folgendes.

Ordner Komponente Beschreibung
MRTK/Core Schnittstellen- und Typdefinitionen, Basisklassen, Standard-Shader.
MRTK/Core/Providers Plattformagnostische Datenanbieter
Hände Basisklassenunterstützung und -dienste für die Handverfolgung.
InputAnimation Unterstützung für die Aufzeichnung von Kopfbewegungen und Handverfolgungsdaten.
InputSimulation Unterstützung für die In-Editor-Simulation von Hand- und Augeneingaben.
ObjectMeshObserver Räumlicher Sensibilisierungsbeobachter mit einem 3D-Modell als Daten.
UnityInput Allgemeine Eingabegeräte (Joystick, Maus usw.), die über die Eingabe-API von Unity implementiert werden.
MRTK/Anbieter Plattformspezifische Datenanbieter
LeapMotion Unterstützung für den UltraLeap Leap Motion-Controller.
OpenVR Unterstützung für OpenVR-Geräte.
Oculus Unterstützung für Oculus-Geräte, z. B. die Quest.
UnityAR (Experimental) Anbieter von Kameraeinstellungen, der MRTK mit mobilen AR-Geräten aktiviert.
WindowsMixedReality Unterstützung für Windows Mixed Reality-Geräte, einschließlich Microsoft HoloLens und immersiver Headsets.
Windows Unterstützung für microsoft Windows-spezifische APIs, z. B. Sprache und Diktieren.
XR SDK (Experimental) Unterstützung für das neue XR-Framework von Unity in Unity 2019.3 und höher.
MRTK/SDK
Experimentell Experimentelle Features, einschließlich Shadern, Benutzeroberflächensteuerelementen und einzelnen Systemmanagern.
Features Funktionalität, die auf dem Foundation-Paket basiert.
Profiles Standardprofile für die Microsoft Mixed Reality Toolkit-Systeme und -Dienste.
StandardAssets Gemeinsame Vermögenswerte; Modelle, Texturen, Materialien usw.
MRTK/SceneSystemResources Ressourcen und Ressourcen, die vom Szenensystem verwendet werden
MRTK/Services
BoundarySystem System, das VR-Grenzunterstützung implementiert.
CameraSystem System zur Implementierung der Kamerakonfiguration und -verwaltung.
DiagnosticsSystem System, das in der Anwendungsdiagnose implementiert wird, z. B. ein visueller Profiler.
InputSystem Das System bietet Unterstützung für den Zugriff auf und die Behandlung von Benutzereingaben.
SceneSystem System, das Multi-Szenen-Anwendungsunterstützung bereitstellt.
SpatialAwarenessSystem Das System bietet Unterstützung für das Bewusstsein für die Umgebung des Benutzers.
TeleportSystem System bietet Unterstützung für Teleporting (Bewegung über die Erfahrung in Sprungs).
MRTK/StandardAssets MRTK Standard-Shader, Grundlegende Materialien und andere Standardressourcen für Mixed Reality-Umgebungen

Erweiterungspaket

Das optionale Microsoft.MixedRealityToolkit.Unity.Extensions-Paket enthält zusätzliche Dienste, die die Funktionalität des Microsoft Mixed Reality Toolkit erweitern.

Hinweis

Das Erweiterungspaket erfordert Microsoft.MixedRealityToolkit.Unity.Foundation.

Ordner Komponente Beschreibung
MRTK/Erweiterungen
HandPhysicsService Dienst, der physische Unterstützung für artikulierte Hände hinzufügt.
LostTrackingService Dienst, der die Behandlung von Nachverfolgungsverlusten auf Microsoft HoloLens-Geräten vereinfacht.
SceneTransitionService Dienst, der das Hinzufügen reibungsloser Szenenübergänge vereinfacht.

Tools-Paket

Das optionale Microsoft.MixedRealityToolkit.Unity.Tools-Paket enthält hilfreiche Tools, die die Mixed Reality-Entwicklungserfahrung mithilfe des Microsoft Mixed Reality-Toolkits verbessern. Diese Tools befinden sich im Menü "Mixed Reality Toolkit > Utilities " im Unity-Editor.

Hinweis

Das Toolspaket erfordert Microsoft.MixedRealityToolkit.Unity.Foundation.

Ordner Komponente Beschreibung
MRTK/Tools
BuildWindow Tool, das das Erstellen und Bereitstellen von UWP-Anwendungen vereinfacht.
DependencyWindow Tool, das eine Abhängigkeitsdiagramm von Ressourcen in einem Projekt erstellt.
ExtensionServiceCreator Assistent zur Unterstützung beim Erstellen von Erweiterungsdiensten.
MigrationWindow Tool zur Unterstützung beim Aktualisieren von Code, der veraltete MRTK-Komponenten verwendet.
OptimizeWindow Hilfsprogramm zum Automatisieren der Konfiguration eines Mixed Reality-Projekts für die beste Leistung in Unity.
ReserializeAssetsUtility Bietet Unterstützung für die Reserialisierung bestimmter Unity-Dateien.
RuntimeTools/Tools/ControllerMappingTool Hilfsprogramm, mit dem Entwickler schnell Unity-Zuordnungen für Hardwarecontroller ermitteln können.
ScreenshotUtility Ermöglicht das Erfassen von Anwendungsbildern im Unity-Editor.
TextureCombinerWindow Hilfsprogramm zum Kombinieren von Grafiktexturen.
Werkzeugkasten Ui, die das Auffinden und Verwenden von MRTK-UX-Komponenten erleichtert.

Testen des Dienstprogrammpakets

Das optionale Microsoft.MixedRealityToolkit.TestUtilities-Paket ist eine Sammlung von Hilfsskripts, mit denen Entwickler problemlos Tests für den Wiedergabemodus erstellen können. Diese Hilfsprogramme sind besonders nützlich für Entwickler, die MRTK-Komponenten erstellen.

Ordner Komponente Beschreibung
MRTK/Tests
TestUtilities Methoden zur Vereinfachung der Erstellung von Spielmodustests, einschließlich Handsimulationsprogrammen.

Beispiele für ein Paket

Das Beispielpaket enthält Demos, Beispielskripts und Beispielszenen, die Funktionen im Foundation-Paket ausüben. Dieses Paket enthält die HandInteractionExample-Szene (unten dargestellt), die Beispielobjekte enthält, die auf verschiedene Arten von Handeingaben reagieren (artikuliert und nicht artikuliert).

HandInteractionExample-Szene

Dieses Paket enthält auch Eye Tracking-Demos, die hier dokumentiert sind

Im Allgemeinen sollte jedes neue Feature in MRTK ein entsprechendes Beispiel im Beispielpaket enthalten, das ungefähr der gleichen Ordnerstruktur und demselben Speicherort folgt.

Hinweis

Das Beispielpaket erfordert Microsoft.MixedRealityToolkit.Unity.Foundation.

Ordner Komponente Beschreibung
MRTK/Beispiele
Demos Einfache Szenen, die ein oder zwei verwandte Features veranschaulichen.
Experimentell Demoszenen, die experimentelle Features veranschaulichen.
StandardAssets Gemeinsame Ressourcen, die von mehreren Demoszenen gemeinsam genutzt werden.

Unity Paket-Manager

Für Erfahrungen, die mit Unity 2019.4 und höher erstellt werden, ist MRTK über die Unity-Paket-Manager verfügbar.

Zu den Vorteilen der Verwendung von Bestandspaketen gehören:

  • Kleinere Projekte
    • Übersichtlichere Visual Studio-Lösungen
    • Weniger Dateien zum Einchecken (MRTK ist ein einfacher Verweis in der Packages/manifest.json Datei)
  • Schnellere Kompilierung
    • Unity muss MRTK während der Erstellung nicht neu kompilieren
  • Abhängigkeitsauflösung
    • Erforderliche MRTK-Pakete werden automatisch installiert, wenn Pakete mit Abhängigkeiten angegeben werden
  • Einfache Aktualisierung auf neue MRTK-Versionen
    • Ändern der Version in der Packages/manifest.json Datei

Beispiele hierfür sind:

  • MRTK ist unveränderlich
    • Änderungen können nicht vorgenommen werden, ohne dass sie während der Paketauflösung entfernt werden.
  • MRTK unterstützt keine UPM-Pakete mit Unity 2018.4

Foundation-Paket

Das Foundation-Paket (com.microsoft.mixedreality.toolkit.foundation) bildet die Grundlage des Mixed Reality-Toolkits.

Ordner Komponente Beschreibung
MRTK/Core Schnittstellen- und Typdefinitionen, Basisklassen, Standard-Shader.
MRTK/Core/Providers Plattformagnostische Datenanbieter
Hände Basisklassenunterstützung und -dienste für die Handverfolgung.
InputAnimation Unterstützung für die Aufzeichnung von Kopfbewegungen und Handverfolgungsdaten.
InputSimulation Unterstützung für die In-Editor-Simulation von Hand- und Augeneingaben.
ObjectMeshObserver Räumlicher Sensibilisierungsbeobachter mit einem 3D-Modell als Daten.
UnityInput Allgemeine Eingabegeräte (Joystick, Maus usw.), die über die Eingabe-API von Unity implementiert werden.
MRTK/Anbieter Plattformspezifische Datenanbieter
LeapMotion Unterstützung für den UltraLeap Leap Motion-Controller.
OpenVR Unterstützung für OpenVR-Geräte.
Oculus Unterstützung für Oculus-Geräte, z. B. die Quest.
UnityAR (Experimental) Anbieter von Kameraeinstellungen, der MRTK mit mobilen AR-Geräten aktiviert.
WindowsMixedReality Unterstützung für Windows Mixed Reality-Geräte, einschließlich Microsoft HoloLens und immersiver Headsets.
Windows Unterstützung für microsoft Windows-spezifische APIs, z. B. Sprache und Diktieren.
XR SDK (Experimental) Unterstützung für das neue XR-Framework von Unity in Unity 2019.3 und höher.
MRTK/SDK
Experimentell Experimentelle Features, einschließlich Shadern, Benutzeroberflächensteuerelementen und einzelnen Systemmanagern.
Features Funktionalität, die auf dem Foundation-Paket basiert.
Profiles Standardprofile für die Microsoft Mixed Reality Toolkit-Systeme und -Dienste.
StandardAssets Gemeinsame Vermögenswerte; Modelle, Texturen, Materialien usw.
MRTK/Services
BoundarySystem System, das VR-Grenzunterstützung implementiert.
CameraSystem System zur Implementierung der Kamerakonfiguration und -verwaltung.
DiagnosticsSystem System, das in der Anwendungsdiagnose implementiert wird, z. B. ein visueller Profiler.
InputSystem Das System bietet Unterstützung für den Zugriff auf und die Behandlung von Benutzereingaben.
SceneSystem System, das Multi-Szenen-Anwendungsunterstützung bereitstellt.
SpatialAwarenessSystem Das System bietet Unterstützung für das Bewusstsein für die Umgebung des Benutzers.
TeleportSystem System bietet Unterstützung für Teleporting (Bewegung über die Erfahrung in Sprungs).

Abhängigkeiten:

  • Standardressourcen (com.microsoft.mixedreality.toolkit.standardassets)

Standardressourcen

Das Standardressourcenpaket (com.microsoft.mixedreality.toolkit.standardassets) ist eine Sammlung von Komponenten, die für alle Mixed Reality-Umgebungen empfohlen werden, einschließlich:

  • MRTK Standard-Shader
  • Grundlegende Materialien mit dem MRTK Standard-Shader
  • Audiodateien
  • Schriftarten
  • Texturen
  • Symbole

Hinweis

Um unterbrechungsbezogene Änderungen basierend auf Assemblydefinitionen zu vermeiden, sind die Skripts, die zum Steuern einiger Features des MRTK Standard-Shaders verwendet werden, nicht im Standardressourcenpaket enthalten. Diese Skripts finden Sie im Foundation-Paket im MRTK/Core/Utilities/StandardShader Ordner.

Abhängigkeiten: keine

Erweiterungspakete

Das optionale Erweiterungspaket (com.microsoft.mixedreality.toolkit.extensions) enthält zusätzliche Komponenten, die die Funktionalität von MRTK erweitern.

Ordner Komponente Beschreibung
MRTK/Erweiterungen
HandPhysicsService Dienst, der physische Unterstützung für artikulierte Hände hinzufügt.
LostTrackingService Dienst, der die Weitergabe von Verlusten auf Microsoft HoloLens-Geräten vereinfacht.
SceneTransitionService Dienst, der das Hinzufügen reibungsloser Szenenübergänge vereinfacht.
Proben~ Ein ausgeblendeter Ordner (im Unity-Editor), der die Beispielszenen und Ressourcen enthält.

Weitere Details zum Verfahren der Verwendung von Paketen mit Beispielprojekten finden Sie im Artikel Mixed Reality Toolkit und Unity Paket-Manager.

Abhängigkeiten:

  • Stiftung (com.microsoft.mixedreality.toolkit.foundation)

Tools-Paket

Das optionale Toolspaket (com.microsoft.mixedreality.toolkit.tools) enthält Tools, die für die Erstellung von Mixed Reality-Umgebungen nützlich sind. Im Allgemeinen sind diese Tools Editorkomponenten, und ihr Code wird nicht als Teil einer Anwendung ausgeliefert.

Ordner Komponente Beschreibung
MRTK/Tools
BuildWindow Tool, das das Erstellen und Bereitstellen von UWP-Anwendungen vereinfacht.
DependencyWindow Tool, das eine Abhängigkeitsdiagramm von Ressourcen in einem Projekt erstellt.
ExtensionServiceCreator Assistent zur Unterstützung beim Erstellen von Erweiterungsdiensten.
MigrationWindow Tool zur Unterstützung beim Aktualisieren von Code, der veraltete MRTK-Komponenten verwendet.
OptimizeWindow Hilfsprogramm zum Automatisieren der Konfiguration eines Mixed Reality-Projekts für die beste Leistung in Unity.
ReserializeAssetsUtility Bietet Unterstützung für die Reserialisierung bestimmter Unity-Dateien.
RuntimeTools/Tools/ControllerMappingTool Hilfsprogramm, mit dem Entwickler schnell Unity-Zuordnungen für Hardwarecontroller ermitteln können.
ScreenshotUtility Ermöglicht das Erfassen von Anwendungsbildern im Unity-Editor.
TextureCombinerWindow Hilfsprogramm zum Kombinieren von Grafiktexturen.
Werkzeugkasten Ui, die das Auffinden und Verwenden von MRTK-UX-Komponenten erleichtert.

Abhängigkeiten:

  • Stiftung (com.microsoft.mixedreality.toolkit.foundation)

Testen des Dienstprogrammpakets

Das optionale Testhilfsprogrammpaket (com.microsoft.mixedreality.toolkit.testutilities) enthält eine Sammlung von Hilfsskripts, mit denen Entwickler problemlos Testmodustests erstellen können. Diese Hilfsprogramme sind besonders nützlich für Entwickler, die MRTK-Komponenten erstellen.

Ordner Komponente Beschreibung
MRTK/Tests
TestUtilities Methoden zur Vereinfachung der Erstellung von Spielmodustests, einschließlich Handsimulationsprogrammen.

Abhängigkeiten:

  • Stiftung (com.microsoft.mixedreality.toolkit.foundation)

Beispiele für ein Paket

Das Beispielpaket (com.microsoft.mixedreality.toolkit.examples) ist so strukturiert, dass Entwickler nur die Beispiele von Interesse importieren können.

Weitere Details zum Verfahren der Verwendung von Paketen mit Beispielprojekten finden Sie im Artikel Mixed Reality Toolkit und Unity Paket-Manager.

Ordner Komponente Beschreibung
MRTK/Beispiele
Proben~ Ein ausgeblendeter Ordner (im Unity-Editor), der die Beispielszenen und Ressourcen enthält.
StandardAssets Gemeinsame Ressourcen, die von mehreren Demoszenen gemeinsam genutzt werden.

Abhängigkeiten:

  • Stiftung (com.microsoft.mixedreality.toolkit.foundation)
  • Erweiterungen (com.microsoft.mixedreality.toolkit.extensions)

Siehe auch