Verwenden von MRTK3-Paketen

  • Artikel

Microsoft MRTK3 wird als eine Reihe von Paketen verteilt, die mit dem Mixed Reality Feature Tool für Unity und dem Unity Package Manager (UPM) in Unity importiert werden. Diese Pakete ermöglichen es Entwicklern, das MRTK innerhalb ihrer Projekte anzupassen.

Abhängigkeiten

Einige MRTK3-Pakete erfordern zusätzliche Pakete, die von Microsoft und/oder Unity bereitgestellt werden, um ordnungsgemäß zu funktionieren. Einige dieser Pakete sind optional und ermöglichen zusätzliche Funktionen.

Das folgende Diagramm veranschaulicht die Beziehung zwischen MRTK-Paketen und einigen der Unity-Abhängigkeiten.

MRTK3-Paket: Diagramm

Hinweis

Beim Importieren von Paketen mithilfe des Mixed Reality Feature-Tools wird die Abhängigkeitsverwaltung automatisch ausgeführt.

Die folgende Tabelle beschreibt die Abhängigkeiten der Mixed Reality Toolkit-Pakete.

Anzeigename Paketname Beschreibung Erforderlich Optional
MRTK-Kerndefinitionen com.microsoft.mrtk.core Freigegebene Definitionen, Dienstprogramme und Komponenten.
  • com.unity.xr.interaction.toolkit
  • com.unity.xr.management
MRTK-Zugänglichkeit com.microsoft.mrtk.accessibility Definitionen, Funktionen und Subsysteme für die Erstellung barrierefreier Mixed-Reality-Erfahrungen.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.textmeshpro
MRTK-Audioeffekte com.microsoft.mrtk.audio Effekte und Features, die die Audiowiedergabe in Mixed Reality-Umgebungen verbessern.
  • com.microsoft.mrtk.core
MRTK Datenbindung und Design com.microsoft.mrtk.data Unterstützung für Datenbindung und Design von UI-Elementen.
  • com.microsoft.mrtk.core
  • com.unity.nuget.newtonsoft-json
  • com.unity.textmeshpro
MRTK-Diagnose com.microsoft.mrtk.diagnostics Diagnose- und Leistungsüberwachungs-Subsysteme und -Tools.
  • com.microsoft.mrtk.core
  • com.unity.xr.management
MRTK-Umgebung com.microsoft.mrtk.environment Umgebungsfeatures und Subsysteme, z. B. räumliches Bewusstsein und Grenzen.
  • com.microsoft.mrtk.core
  • com.unity.xr.management
Erweiterte MRTK-Assets com.microsoft.mrtk.extendedassets Zusätzliche Audio-, Schriftart-, Textur- und andere Assets zur Verwendung in Anwendungen.
  • com.microsoft.mrtk.standardassets
  • com.microsoft.mrtk.graphicstools.unity
MRTK-Grafiktools com.microsoft.mrtk.graphicstools.unity Shader, Texturen, Materialien und Modelle.
  • com.unity.render-pipelines.universal
MRTK Input com.microsoft.mrtk.input Eingabekomponenten einschließlich Unterstützung für artikulierte Hände, Offline-Spracherkennung und Eingabesimulation im Editor.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.xr.interaction.toolkit
  • com.unity.inputsystem
  • com.unity.xr.management
  • com.unity.xr.openxr
  • com.unity.xr.arfoundation
MRTK Räumliche Manipulation com.microsoft.mrtk.spatialmanipulation Räumliche Positionierungs- und Manipulationskomponenten und -Dienstprogramme, einschließlich Solver.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.uxcore
  • com.unity.inputsystem
  • com.unity.xr.interaction.toolkit
  • com.microsoft.mrtk.input
MRTK Standard Assets com.microsoft.mrtk.standardassets Standard-Assets, einschließlich Materialien und Texturen, zur Verwendung durch Anwendungen.
  • com.microsoft.mrtk.graphicstools.unity
MRTK-Tools com.microsoft.mrtk.tools Sammlung von Unity Editor-Tools, die zum Erweitern und Optimieren von MRTK3-Anwendungen verwendet werden.
  • com.microsoft.mrtk.core
MRTK UX-Komponenten com.microsoft.mrtk.uxcomponents MRTK UX-Komponentenbibliothek, die Prefabs, Visuals, vorgefertigte Steuerelemente und alles enthält, um mit dem Erstellen von 3D-Benutzeroberflächen für Mixed Reality zu beginnen.
  • com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.standardassets
MRTK-UX-Komponenten (nicht zeichenbereichbasiert) com.microsoft.mrtk.uxcomponents.noncanvas Bibliothek mit nicht zeichenbereichbasierten MRTK-UX-Komponenten zum Erstellen von 3D-Benutzerumgebungen ohne Zeichenbereichlayout. Für die meisten Benutzeroberflächen auf Produktionsniveau empfiehlt sich die Verwendung der dynamischen zeichenbereichbasierten UX-Hybridsysteme in „com.microsoft.mrtk.uxcomponents“. In einigen Fällen bietet die statische/nicht zeichenbereichbasierte Benutzeroberfläche jedoch ggf. eine höhere Leistung und besseres Batching und ist in Szenarien mit eingeschränkten Ressourcen unter Umständen die bessere Wahl.
  • com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.standardassets
MRTK UX-Kern com.microsoft.mrtk.uxcore Kerninteraktions- und Visualisierungsskripte für die Erstellung von MR-Benutzeroberflächenkomponenten.\n\nHinweis: Diese Skripte sind für die Erstellung von UX-Bibliotheken gedacht. Informationen zum Erstellen von MR-Schnittstellen mit einer vorab vorhandenen Bibliothek von Komponenten finden Sie unter com.microsoft.mrtk.uxcomponents.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.inputsystem
  • com.unity.textmeshpro
  • com.unity.xr.interaction.toolkit
  • com.microsoft.mrtk.data
MRTK-Windows-Sprache com.microsoft.mrtk.windowsspeech Implementierung des Sprachsubsystems für systemeigene Windows-Sprach-APIs. Ermöglicht die Verwendung der systemeigenen Windows-Spracherkennung, um Ereignisse auszulösen und XRI-Interaktionen zu steuern.
  • com.microsoft.mrtk.core

Pakettests ausführen

Einige MRTK-Pakete enthalten Tests zur Überprüfung der enthaltenen Komponenten. In einigen Fällen erfordern diese Tests zusätzliche MRTK-Pakete, die nicht als Abhängigkeiten geltend gemacht werden.

Hinweis

Beim Importieren von Paketen in Unity werden Testassemblys standardmäßig nicht kompiliert. Um die Kompilierung von Tests zu ermöglichen, verwenden Sie bitte das Element testables in der manifest.json-Datei des Projekts.

Um den Aufwand für Anwendungen, die das Mixed Reality-Toolkit importieren, möglichst gering zu halten, werden Abhängigkeiten nur für Laufzeitanforderungen geltend gemacht. Die folgende Tabelle beschreibt die zusätzlichen Pakete, die zum Kompilieren und Ausführen der enthaltenen Testassemblys erforderlich sind.

Anzeigename Paketname Testanforderungen
MRTK-Kerndefinitionen com.microsoft.mrtk.core
MRTK-Zugänglichkeit com.microsoft.mrtk.accessibility
MRTK Datenbindung und Design com.microsoft.mrtk.data
MRTK-Diagnose com.microsoft.mrtk.diagnostics
MRTK-Umgebung com.microsoft.mrtk.environment
Erweiterte MRTK-Assets com.microsoft.mrtk.extendedassets
MRTK Input com.microsoft.mrtk.input
MRTK Räumliche Manipulation com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.mrtk.input
MRTK Standard Assets com.microsoft.mrtk.standardassets
MRTK UX-Komponenten com.microsoft.mrtk.uxcomponents
  • com.microsoft.mrtk.input
MRTK UX-Kern com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.input
MRTK-Windows-Sprache com.microsoft.mrtk.windowsspeech