Utilisation de packages MRTK3

Microsoft MRTK3 est distribué en tant qu’ensemble de packages importés dans Unity à l’aide de l’outil de fonctionnalité de réalité mixte pour Unity et du Gestionnaire de package Unity (UPM). Ces packages permettent aux développeurs de personnaliser MRTK au sein de leurs projets.

Les dépendances

Certains packages MRTK3 nécessitent des packages supplémentaires, fournis par Microsoft et/ou Unity, afin de fonctionner correctement. Certains de ces packages sont facultatifs et activeront des fonctionnalités supplémentaires.

Le diagramme suivant illustre la relation entre les packages MRTK et certaines dépendances Unity.

Remarque

Quand vous importez des packages avec Mixed Reality Feature Tool, la gestion des dépendances est automatiquement effectuée.

Le tableau suivant décrit les dépendances du package Mixed Reality Toolkit.

Nom d’affichage	Nom du package	Description	Obligatoire	Facultatif
Définitions de base MRTK	com.microsoft.mrtk.core	Définitions partagées, utilitaires et composants.	com.unity.xr.interaction.toolkit com.unity.xr.management
Accessibilité MRTK	com.microsoft.mrtk.accessibility	Définitions, fonctionnalités et sous-système pour la création d’expériences de réalité mixte accessibles.	com.microsoft.mrtk.core com.microsoft.mrtk.graphicstools.unity com.unity.textmeshpro
Effets audio MRTK	com.microsoft.mrtk.audio	Effets et fonctionnalités qui améliorent l’audio dans les expériences de réalité mixte.	com.microsoft.mrtk.core
Liaison de données et de thématisation MRTK	com.microsoft.mrtk.data	Prise en charge de la liaison de données et du thème des éléments d’interface utilisateur.	com.microsoft.mrtk.core com.unity.nuget.newtonsoft-json com.unity.textmeshpro
Diagnostics MRTK	com.microsoft.mrtk.diagnostics	Sous-systèmes et outils de supervision des performances et des diagnostics.	com.microsoft.mrtk.core com.unity.xr.management
Environnement MRTK	com.microsoft.mrtk.environment	Fonctionnalités environnementales et sous-systèmes, tels que la sensibilisation spatiale et les limites.	com.microsoft.mrtk.core com.unity.xr.management
Ressources étendues MRTK	com.microsoft.mrtk.extendedassets	Audio, police, texture et autres ressources supplémentaires à utiliser dans les applications.	com.microsoft.mrtk.standardassets com.microsoft.mrtk.graphicstools.unity
Outils graphiques MRTK	com.microsoft.mrtk.graphicstools.unity	Nuanceurs, textures, matériaux et modèles.		com.unity.render-pipelines.universal
Entrée MRTK	com.microsoft.mrtk.input	Composants d’entrée, notamment la prise en charge des mains articulées, de la reconnaissance vocale hors connexion et de la simulation d’entrée dans l’éditeur.	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
Manipulation spatiale MRTK	com.microsoft.mrtk.spatialmanipulation	Composants et utilitaires de positionnement spatial et de manipulation, y compris les résolveurs.	com.microsoft.mrtk.core com.microsoft.mrtk.uxcore com.unity.inputsystem com.unity.xr.interaction.toolkit	com.microsoft.mrtk.input
Ressources Standard MRTK	com.microsoft.mrtk.standardassets	Ressources standard, y compris les matériaux et les textures, à utiliser par les applications.	com.microsoft.mrtk.graphicstools.unity
Outils MRTK	com.microsoft.mrtk.tools	Collection d’outils de l’Éditeur Unity utilisés pour étendre et optimiser les applications MRTK3.	com.microsoft.mrtk.core
Composants d’expérience utilisateur MRTK	com.microsoft.mrtk.uxcomponents	Bibliothèque de composants UX MRTK, contenant des préfabriqués, des visuels, des contrôles prédéfinis et tout ce qui permet de commencer à créer des interfaces utilisateur 3D pour la réalité mixte.	com.microsoft.mrtk.uxcore com.microsoft.mrtk.spatialmanipulation com.microsoft.standardassets
MRTK UX Components (Non-Canvas)	com.microsoft.mrtk.uxcomponents.noncanvas	Bibliothèque de composants d’expérience utilisateur non canevas MRTK pour créer des expériences utilisateur 3D sans disposition de type canevas. Pour la plupart des interfaces utilisateur de niveau production, nous recommandons les systèmes d’expérience utilisateur hybrides et dynamiques basés sur canevas, qui se trouvent dans com.microsoft.mrtk.uxcomponents. Cependant, dans certaines cas, l’interface utilisateur statique/sans canevas peut offrir des performances et un traitement par lot supérieurs, et peut s’avérer souhaitable dans les scénarios où les ressources sont limitées.	com.microsoft.mrtk.uxcore com.microsoft.mrtk.spatialmanipulation com.microsoft.standardassets
UX Core MRTK	com.microsoft.mrtk.uxcore	Scripts d’interaction et de visualisation principaux pour la création de composants d’interface utilisateur MR.\n\nRemarque : il s’agit d’un objectif à consommer pour générer des bibliothèques d’expérience utilisateur. Pour créer des interfaces MR avec une bibliothèque de composants préexistante, consultez 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
Windows Speech MRTK	com.microsoft.mrtk.windowsspeech	Implémentation du sous-système Speech pour les API vocales Windows natives. Permet l’utilisation de la reconnaissance vocale Windows native pour déclencher des événements et générer des interactions XRI.	com.microsoft.mrtk.core

Exécution de tests de package

Certains packages MRTK contiennent des tests utilisés pour valider les composants inclus. Dans certains cas, ces tests nécessitent des packages MRTK supplémentaires non déclarés en tant que dépendances.

Remarque

Quand vous importez des packages dans Unity, les assemblages de test ne sont pas compilés par défaut. Pour activer la compilation des tests, utilisez l’élément testables du fichier manifest.json du projet.

Pour placer une surcharge minimale sur les applications qui importent mixed Reality Toolkit, les dépendances sont déclarées uniquement pour les exigences d’exécution. Le tableau suivant décrit les packages supplémentaires requis pour activer la compilation et l’exécution des assemblages de test inclus.

Nom d’affichage	Nom du package	Spécifications de test
Définitions de base MRTK	com.microsoft.mrtk.core
Accessibilité MRTK	com.microsoft.mrtk.accessibility
Liaison de données et de thématisation MRTK	com.microsoft.mrtk.data
Diagnostics MRTK	com.microsoft.mrtk.diagnostics
Environnement MRTK	com.microsoft.mrtk.environment
Ressources étendues MRTK	com.microsoft.mrtk.extendedassets
Entrée MRTK	com.microsoft.mrtk.input
Manipulation spatiale MRTK	com.microsoft.mrtk.spatialmanipulation	com.microsoft.mrtk.input
Ressources Standard MRTK	com.microsoft.mrtk.standardassets
Composants d’expérience utilisateur MRTK	com.microsoft.mrtk.uxcomponents	com.microsoft.mrtk.input
UX Core MRTK	com.microsoft.mrtk.uxcore	com.microsoft.mrtk.input
Windows Speech MRTK	com.microsoft.mrtk.windowsspeech