MRTK-Pakete — MRTK2

  • Artikel

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

MRTK ist als Ressourcenpakete (.unitypackage) und über den Unity-Paket-Manager verfügbar.

Bestandspakete

Das MRTK-Asset (.unitypackage) kann von GitHub heruntergeladen werden.

Zu den Vorteilen der Verwendung von Ressourcenpaketen gehören:

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

Beispiele hierfür sind:

  • MRTK ist Teil des Ordners Assets des Projekts und führt zu
    • Größere Projekte
    • Langsamere Kompilierungszeiten
  • Keine Abhängigkeitsverwaltung
    • Kunden müssen Paketabhängigkeiten manuell auflösen.
  • Manueller Updateprozess
    • Mehrere Schritte
    • Updates für die Quellcodeverwaltung mit großem Umfang (3000+ Dateien)
    • Risiko, dass an MRTK vorgenommene Änderungen verloren gehen
  • 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 Codesatz, mit dem Ihre Anwendung allgemeine Funktionen auf Mixed Reality Plattformen nutzen kann.

Pakage FoundationMRTK Foundation Package

Das MRTK Foundation-Paket enthält Folgendes.

Ordner Komponente BESCHREIBUNG
MRTK/Core Schnittstellen- und Typdefinitionen, Basisklassen, Standard-Shader.
MRTK/Kern/Anbieter Plattformunabhängige Datenanbieter
Hände Basisklassenunterstützung und Dienste für die Handnachverfolgung.
InputAnimation Unterstützung für die Aufzeichnung von Kopfbewegungen und Handverfolgungsdaten.
InputSimulation Unterstützung für die Im-Editor-Simulation von Hand- und Augeneingaben.
ObjectMeshObserver Räumlicher Wahrnehmungsbeobachter, der ein 3D-Modell als Daten verwendet.
UnityInput Gängige 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. quest.
UnityAR (Experimentell) Kameraeinstellungsanbieter, der die MRTK-Verwendung mit mobilen AR-Geräten ermöglicht.
WindowsMixedReality Unterstützung für Windows Mixed Reality Geräte, einschließlich Microsoft HoloLens und immersiven Headsets.
Windows Unterstützung für Microsoft Windows-spezifische APIs, z. B. Sprache und Diktieren.
XR SDK (Experimentell) Unterstützung für das neue XR-Framework von Unity in Unity 2019.3 und höher.
MRTK/SDK
Experimentell Experimentelle Features, z. B. Shader, Benutzeroberflächensteuerelemente und einzelne Systemmanager.
Features Funktionalität, die auf dem Foundation-Paket aufbaut.
Profiles Standardprofile für die Microsoft Mixed Reality Toolkit-Systeme und -Dienste.
StandardAssets Gemeinsame Ressourcen; Modelle, Texturen, Materialien usw.
MRTK/SceneSystemResources Vom Szenensystem verwendete Ressourcen und Ressourcen
MRTK/Services
BoundarySystem Unterstützung für die Implementierung von VR-Begrenzungen durch das System.
CameraSystem System zur Implementierung der Kamerakonfiguration und -verwaltung.
DiagnosticsSystem System implementiert in Anwendung Diagnose, z. B. ein visueller Profiler.
InputSystem System, das Unterstützung für den Zugriff auf und die Verarbeitung von Benutzereingaben bereitstellt.
SceneSystem System, das Unterstützung für anwendungen mit mehreren Szenen bereitstellt.
SpatialAwarenessSystem System, das Unterstützung für das Bewusstsein für die Umgebung des Benutzers bereitstellt.
TeleportSystem System, das Unterstützung für Teleporting (Bewegen der Erfahrung in Sprüngen) bietet.
MRTK/StandardAssets MRTK Standard-Shader, Grundmaterialien und andere Standardressourcen für Mixed Reality-Erfahrungen

Erweiterungspaket

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

Hinweis

Das Erweiterungspaket erfordert Microsoft.MixedRealityToolkit.Unity.Foundation.

Ordner Komponente BESCHREIBUNG
MRTK/Erweiterungen
HandPhysicsService Dienst, der Physikunterstü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-Entwicklungsumgebung mithilfe des Microsoft Mixed Reality Toolkits verbessern. Diese Tools befinden sich im Unity-Editor im Menü Mixed Reality Toolkit-Hilfsprogramme>.

Hinweis

Das Toolspaket erfordert Microsoft.MixedRealityToolkit.Unity.Foundation.

Ordner Komponente BESCHREIBUNG
MRTK/Tools
BuildWindow Tool, das das Erstellen und Bereitstellen von UWP-Anwendungen vereinfacht.
AbhängigkeitWindow Tool, das eine Abhängigkeitsdiagramm von Ressourcen in einem Projekt erstellt.
ExtensionServiceCreator Assistent zur Unterstützung beim Erstellen von Erweiterungsdiensten.
MigrationWindow Tool, das beim Aktualisieren von Code hilft, 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, das Es Entwicklern ermöglicht, Unity-Zuordnungen für Hardwarecontroller schnell zu ermitteln.
ScreenshotUtility Ermöglicht die Erfassung von Anwendungsbildern im Unity-Editor.
TextureCombinerWindow Hilfsprogramm zum Kombinieren von Grafiktexturen.
Werkzeugkasten Benutzeroberfläche, die das Erkennen und Verwenden von MRTK-UX-Komponenten erleichtert.

Testhilfsprogrammpaket

Das optionale Microsoft.MixedRealityToolkit.TestUtilities-Paket ist eine Sammlung von Hilfsskripts, mit denen Entwickler problemlos Tests im 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 Tests im Spielmodus, einschließlich Handsimulationshilfsprogrammen.

Beispielpaket

Das Beispielpaket enthält Demos, Beispielskripts und Beispielszenen, in denen Funktionen im Foundation-Paket ausgeführt werden. Dieses Paket enthält die HandInteractionExample-Szene (abbildung unten), die Beispielobjekte enthält, die auf verschiedene Arten von Handeingaben reagieren (artikuliert und nicht artikuliert).

HandInteractionBeispiel-Szene

Dieses Paket enthält auch Eyetracking-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 Merkmale veranschaulichen.
Experimentell Demoszenen zur Veranschaulichung experimenteller Features.
StandardAssets Gemeinsame Ressourcen, die von mehreren Demoszenen gemeinsam genutzt werden.

Unity-Paket-Manager

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

Zu den Vorteilen der Verwendung von Ressourcenpaketen gehören:

  • Kleinere Projekte
    • Bereinigung von Visual Studio-Projektmappen
    • Weniger Einzucheckende Dateien (MRTK ist ein einfacher Verweis in der Packages/manifest.json Datei)
  • Schnellere Kompilierung
    • Unity muss MRTK während der Erstellung nicht erneut kompilieren.
  • Abhängigkeitsauflösung
    • Erforderliche MRTK-Pakete werden automatisch installiert, wenn Pakete mit Abhängigkeiten angegeben werden.
  • Einfaches Update 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 für Mixed Reality Toolkit.

Ordner Komponente BESCHREIBUNG
MRTK/Core Schnittstellen- und Typdefinitionen, Basisklassen, Standard-Shader.
MRTK/Kern/Anbieter Plattformunabhängige Datenanbieter
Hände Basisklassenunterstützung und Dienste für die Handnachverfolgung.
InputAnimation Unterstützung für die Aufzeichnung von Kopfbewegungen und Handverfolgungsdaten.
InputSimulation Unterstützung für die Im-Editor-Simulation von Hand- und Augeneingaben.
ObjectMeshObserver Räumlicher Wahrnehmungsbeobachter, der ein 3D-Modell als Daten verwendet.
UnityInput Gängige 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. quest.
UnityAR (Experimentell) Kameraeinstellungsanbieter, der die MRTK-Verwendung mit mobilen AR-Geräten ermöglicht.
WindowsMixedReality Unterstützung für Windows Mixed Reality Geräte, einschließlich Microsoft HoloLens und immersiven Headsets.
Windows Unterstützung für Microsoft Windows-spezifische APIs, z. B. Sprache und Diktieren.
XR SDK (Experimentell) Unterstützung für das neue XR-Framework von Unity in Unity 2019.3 und höher.
MRTK/SDK
Experimentell Experimentelle Features, z. B. Shader, Benutzeroberflächensteuerelemente und einzelne Systemmanager.
Features Funktionalität, die auf dem Foundation-Paket aufbaut.
Profiles Standardprofile für die Microsoft Mixed Reality Toolkit-Systeme und -Dienste.
StandardAssets Gemeinsame Ressourcen; Modelle, Texturen, Materialien usw.
MRTK/Services
BoundarySystem Unterstützung für die Implementierung von VR-Begrenzungen durch das System.
CameraSystem System zur Implementierung der Kamerakonfiguration und -verwaltung.
DiagnosticsSystem System implementiert in Anwendung Diagnose, z. B. ein visueller Profiler.
InputSystem System, das Unterstützung für den Zugriff auf und die Verarbeitung von Benutzereingaben bereitstellt.
SceneSystem System, das Unterstützung für anwendungen mit mehreren Szenen bereitstellt.
SpatialAwarenessSystem System, das Unterstützung für das Bewusstsein für die Umgebung des Benutzers bereitstellt.
TeleportSystem System, das Unterstützung für Teleporting (Bewegen der Erfahrung in Sprüngen) bietet.

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
  • Grundmaterialien mit dem MRTK Standard-Shader
  • Audiodateien
  • Schriftarten
  • Texturen
  • Symbole

Hinweis

Um Breaking Changes basierend auf Assemblydefinitionen zu vermeiden, sind die Skripts zum Steuern einiger Features des MRTK Standard-Shaders 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 Physikunterstützung für artikulierte Hände hinzufügt.
LostTrackingService Dienst, der die Übergabe von Nachverfolgungsverlusten 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 -objekte enthält.

Weitere Informationen zur Verwendung von Paketen, die Beispielprojekte enthalten, finden Sie im Artikel Mixed Reality Toolkit und Unity-Paket-Manager.

Abhängigkeiten:

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

Tools-Paket

Das optionale Toolspaket (com.microsoft.mixedreality.toolkit.tools) enthält Tools, die zum Erstellen von Mixed Reality-Umgebungen nützlich sind. Im Allgemeinen handelt es sich bei diesen Tools um Editorkomponenten, deren Code nicht als Teil einer Anwendung geliefert wird.

Ordner Komponente BESCHREIBUNG
MRTK/Tools
BuildWindow Tool, das das Erstellen und Bereitstellen von UWP-Anwendungen vereinfacht.
AbhängigkeitWindow Tool, das eine Abhängigkeitsdiagramm von Ressourcen in einem Projekt erstellt.
ExtensionServiceCreator Assistent zur Unterstützung beim Erstellen von Erweiterungsdiensten.
MigrationWindow Tool, das beim Aktualisieren von Code hilft, 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, das Es Entwicklern ermöglicht, Unity-Zuordnungen für Hardwarecontroller schnell zu ermitteln.
ScreenshotUtility Ermöglicht die Erfassung von Anwendungsbildern im Unity-Editor.
TextureCombinerWindow Hilfsprogramm zum Kombinieren von Grafiktexturen.
Werkzeugkasten Benutzeroberfläche, die das Erkennen und Verwenden von MRTK-UX-Komponenten erleichtert.

Abhängigkeiten:

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

Testhilfsprogrammpaket

Das optionale Testhilfsprogrammpaket (com.microsoft.mixedreality.toolkit.testutilities) enthält eine Sammlung von Hilfsskripts, mit denen Entwickler problemlos Tests im Playmodus 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 Tests im Spielmodus, einschließlich Handsimulationshilfsprogrammen.

Abhängigkeiten:

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

Beispielpaket

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

Weitere Informationen zur Verwendung von Paketen, die Beispielprojekte enthalten, 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 -objekte enthält.
StandardAssets Gemeinsame Ressourcen, die von mehreren Demoszenen gemeinsam genutzt werden.

Abhängigkeiten:

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

Weitere Informationen