MRTK packages — MRTK2
Mixed Reality Toolkit (MRTK) est une collection de packages qui permettent le développement d’applications de réalité mixte multiplateforme en fournissant la prise en charge du matériel et des plateformes de réalité mixte.
MRTK est disponible en tant que packages asset (.unitypackage) et via le Gestionnaire de package Unity.
Packages de composants
La ressource MRTK (.unitypackage) peut être téléchargée à partir de GitHub.
Voici quelques-uns des avantages de l’utilisation de packages d’éléments multimédias :
- Disponible pour Unity 2018.4 et versions ultérieures
- Facile d’apporter des modifications à MRTK
- MRTK se trouve dans le dossier Assets
Voici quelques-unes des difficultés :
- MRTK fait partie du dossier Assets du projet, ce qui mène à
- Projets plus volumineux
- Temps de compilation plus lents
- Aucune gestion des dépendances
- Les clients doivent résoudre manuellement les dépendances de package
- Processus de mise à jour manuelle
- Plusieurs étapes
- Mises à jour du contrôle de code source volumineux (3000+ fichier)
- Risque de perte de modifications apportées à MRTK
- L’importation du package d’exemples signifie généralement inclure tous les exemples
Les packages disponibles sont les suivants :
Ces packages sont publiés et pris en charge par Microsoft à partir du code source sur GitHub.
Package Foundation
Mixed Reality Toolkit Foundation est l’ensemble de code qui permet à votre application de tirer parti des fonctionnalités courantes sur les plateformes de réalité mixte.
MRTK Foundation Package
Le package MRTK Foundation contient les éléments suivants.
| Dossier | Composant | Description |
|---|---|---|
| MRTK/Core | Définitions d’interface et de type, classes de base, nuanceur standard. | |
| MRTK/Core/Providers | Fournisseurs de données indépendants de la plateforme | |
| Mains | Prise en charge et services de classe de base pour le suivi des mains. | |
| InputAnimation | Prise en charge de l’enregistrement des données de déplacement de la tête et de suivi des mains. | |
| InputSimulation | Prise en charge de la simulation dans l’éditeur de la main et de l’entrée oculaire. | |
| ObjectMeshObserver | Observateur de sensibilisation spatiale à l’aide d’un modèle 3D en tant que données. | |
| UnityInput | Appareils d’entrée courants (joystick, souris, etc.) implémentés via l’API d’entrée d’Unity. | |
| MRTK/Providers | Fournisseurs de données spécifiques à la plateforme | |
| LeapMotion | Prise en charge du contrôleur UltraLeap Leap Motion. | |
| OpenVR | Prise en charge des appareils OpenVR. | |
| Oculus | Prise en charge des appareilsux, tels que la quête. | |
| UnityAR | (Expérimental) Fournisseur de paramètres de caméra permettant l’utilisation de MRTK avec des appareils AR mobiles. | |
| WindowsMixedReality | Prise en charge des appareils Windows Mixed Reality, notamment Microsoft HoloLens et casques immersifs. | |
| Windows | Prise en charge des API spécifiques à Microsoft Windows, par exemple la reconnaissance vocale et la dictée. | |
| Kit de développement logiciel (SDK) XR | (Expérimental) Prise en charge du nouveau framework XR d’Unity dans Unity 2019.3 et versions ultérieures. | |
| MRTK/SDK | ||
| Expérimental | Fonctionnalités expérimentales, notamment les nuanceurs, les contrôles d’interface utilisateur et les gestionnaires de systèmes individuels. | |
| Fonctionnalités | Fonctionnalités qui s’appuient sur le package Foundation. | |
| Profiles | Profils par défaut pour les systèmes et services Microsoft Mixed Reality Toolkit. | |
| StandardAssets | Ressources courantes ; modèles, textures, matériaux, etc. | |
| MRTK/SceneSystemResources | Ressources et ressources utilisées par le système de scène | |
| MRTK/Services | ||
| BoundarySystem | Système implémentant la prise en charge des limites VR. | |
| CameraSystem | Système implémentant la configuration et la gestion de la caméra. | |
| DiagnosticsSystem | Implémentation du système dans les diagnostics d’application, par exemple un profileur visuel. | |
| InputSystem | Système fournissant la prise en charge de l’accès et de la gestion des entrées utilisateur. | |
| SceneSystem | Système fournissant une prise en charge d’application multisétaire. | |
| SpatialAwarenessSystem | Système fournissant une prise en charge de la sensibilisation de l’environnement de l’utilisateur. | |
| TeleportSystem | Système fournissant une prise en charge de la téléportation (déplacement de l’expérience en sauts). | |
| MRTK/StandardAssets | Nuanceur MRTK Standard, matériaux de base et autres ressources standard pour les expériences de réalité mixte |
Package d’extensions
Le package Facultatif Microsoft.MixedRealityToolkit.Unity.Extensions inclut des services supplémentaires qui étendent les fonctionnalités de Microsoft Mixed Reality Toolkit.
Remarque
Le package d’extensions nécessite Microsoft.MixedRealityToolkit.Unity.Foundation.
| Dossier | Composant | Description |
|---|---|---|
| MRTK/Extensions | ||
| HandPhysicsService | Service qui ajoute la prise en charge physique aux mains articulées. | |
| LostTrackingService | Service qui simplifie la gestion de la perte de suivi sur les appareils Microsoft HoloLens. | |
| SceneTransitionService | Service qui simplifie l’ajout de transitions de scène fluide. |
Package d’outils
Le package Facultatif Microsoft.MixedRealityToolkit.Unity.Tools inclut des outils utiles qui améliorent l’expérience de développement de réalité mixte à l’aide de Microsoft Mixed Reality Toolkit. Ces outils se trouvent dans le menu Utilitaires mixed Reality Toolkit > dans l’éditeur Unity.
Remarque
Le package d’outils nécessite Microsoft.MixedRealityToolkit.Unity.Foundation.
| Dossier | Composant | Description |
|---|---|---|
| MRTK/Tools | ||
| BuildWindow | Outil qui permet de simplifier le processus de création et de déploiement d’applications UWP. | |
| DependencyWindow | Outil qui crée une graphe des dépendances de ressources dans un projet. | |
| ExtensionServiceCreator | Assistant pour faciliter la création de services d’extension. | |
| MigrationWindow | Outil qui aide à mettre à jour le code qui utilise des composants MRTK déconseillés. | |
| OptimizeWindow | Utilitaire permettant d’automatiser la configuration d’un projet de réalité mixte pour obtenir les meilleures performances dans Unity. | |
| ReserializeAssetsUtility | Fournit la prise en charge de la resérialisation des fichiers Unity spécifiques. | |
| RuntimeTools/Tools/ControllerMappingTool | Utilitaire permettant aux développeurs de déterminer rapidement les mappages Unity pour les contrôleurs matériels. | |
| Capture d’écranUtility | Permet de capturer des images d’application dans l’éditeur Unity. | |
| TextureCombinerWindow | Utilitaire pour combiner des textures graphiques. | |
| Boîte à outils | Interface utilisateur qui facilite la découverte et l’utilisation des composants d’expérience utilisateur MRTK. |
Package d’utilitaires de test
Le package Facultatif Microsoft.MixedRealityToolkit.TestUtilities est une collection de scripts d’assistance qui permettent aux développeurs de créer facilement des tests en mode lecture. Ces utilitaires sont particulièrement utiles pour les développeurs qui créent des composants MRTK.
| Dossier | Composant | Description |
|---|---|---|
| MRTK/Tests | ||
| TestUtilities | Méthodes pour simplifier la création de tests en mode lecture, y compris les utilitaires de simulation manuelle. |
Package d’exemples
Le package d’exemples contient des démonstrations, des exemples de scripts et des exemples de scènes qui exercent des fonctionnalités dans le package de base. Ce package contient la scène HandInteractionExample (illustré ci-dessous) qui contient des exemples d’objets qui répondent à différents types d’entrée manuelle (articulés et non articulés).
Ce package contient également des démonstrations de suivi oculaire, qui sont documentées ici
Plus généralement, toute nouvelle fonctionnalité de MRTK doit contenir un exemple correspondant dans le package d’exemples, à peu près en suivant la même structure de dossiers et l’emplacement.
Remarque
Le package d’exemples nécessite Microsoft.MixedRealityToolkit.Unity.Foundation.
| Dossier | Composant | Description |
|---|---|---|
| MRTK/Exemples | ||
| Démonstrations | Scènes simples illustrant une ou deux fonctionnalités connexes. | |
| Expérimental | Scènes de démonstration illustrant des fonctionnalités expérimentales. | |
| StandardAssets | Ressources communes partagées par plusieurs scènes de démonstration. |
Gestionnaire de package Unity
Pour les expériences créées à l’aide d’Unity 2019.4 et versions ultérieures, MRTK est disponible via le Gestionnaire de package Unity.
Voici quelques-uns des avantages de l’utilisation de packages d’éléments multimédias :
- Projets plus petits
- Solutions Visual Studio plus propres
- Moins de fichiers à archiver (MRTK est une référence simple dans le
Packages/manifest.jsonfichier)
- Compilation plus rapide
- Unity n’a pas besoin de recompiler MRTK pendant la génération
- Résolution des dépendances
- Les packages MRTK requis sont automatiquement installés lors de la spécification de packages avec des dépendances
- Mise à jour facile des nouvelles versions de MRTK
- Modifier la version dans le
Packages/manifest.jsonfichier
- Modifier la version dans le
Voici quelques-unes des difficultés :
- MRTK est immuable
- Impossible d’apporter des modifications sans qu’elles soient supprimées pendant la résolution de package
- MRTK ne prend pas en charge les packages UPM avec Unity 2018.4
Package Foundation
Le package de base (com.microsoft.mixedreality.toolkit.foundation) constitue la base de Mixed Reality Toolkit.
| Dossier | Composant | Description |
|---|---|---|
| MRTK/Core | Définitions d’interface et de type, classes de base, nuanceur standard. | |
| MRTK/Core/Providers | Fournisseurs de données indépendants de la plateforme | |
| Mains | Prise en charge et services de classe de base pour le suivi des mains. | |
| InputAnimation | Prise en charge de l’enregistrement des données de déplacement de la tête et de suivi des mains. | |
| InputSimulation | Prise en charge de la simulation dans l’éditeur de la main et de l’entrée oculaire. | |
| ObjectMeshObserver | Observateur de sensibilisation spatiale à l’aide d’un modèle 3D en tant que données. | |
| UnityInput | Appareils d’entrée courants (joystick, souris, etc.) implémentés via l’API d’entrée d’Unity. | |
| MRTK/Providers | Fournisseurs de données spécifiques à la plateforme | |
| LeapMotion | Prise en charge du contrôleur UltraLeap Leap Motion. | |
| OpenVR | Prise en charge des appareils OpenVR. | |
| Oculus | Prise en charge des appareilsux, tels que la quête. | |
| UnityAR | (Expérimental) Fournisseur de paramètres de caméra permettant l’utilisation de MRTK avec des appareils AR mobiles. | |
| WindowsMixedReality | Prise en charge des appareils Windows Mixed Reality, notamment Microsoft HoloLens et casques immersifs. | |
| Windows | Prise en charge des API spécifiques à Microsoft Windows, par exemple la reconnaissance vocale et la dictée. | |
| Kit de développement logiciel (SDK) XR | (Expérimental) Prise en charge du nouveau framework XR d’Unity dans Unity 2019.3 et versions ultérieures. | |
| MRTK/SDK | ||
| Expérimental | Fonctionnalités expérimentales, notamment les nuanceurs, les contrôles d’interface utilisateur et les gestionnaires de systèmes individuels. | |
| Fonctionnalités | Fonctionnalités qui s’appuient sur le package Foundation. | |
| Profiles | Profils par défaut pour les systèmes et services Microsoft Mixed Reality Toolkit. | |
| StandardAssets | Ressources courantes ; modèles, textures, matériaux, etc. | |
| MRTK/Services | ||
| BoundarySystem | Système implémentant la prise en charge des limites VR. | |
| CameraSystem | Système implémentant la configuration et la gestion de la caméra. | |
| DiagnosticsSystem | Implémentation du système dans les diagnostics d’application, par exemple un profileur visuel. | |
| InputSystem | Système fournissant la prise en charge de l’accès et de la gestion des entrées utilisateur. | |
| SceneSystem | Système fournissant une prise en charge d’application multisétaire. | |
| SpatialAwarenessSystem | Système fournissant une prise en charge de la sensibilisation de l’environnement de l’utilisateur. | |
| TeleportSystem | Système fournissant une prise en charge de la téléportation (déplacement de l’expérience en sauts). |
Dépendances :
- Ressources standard (
com.microsoft.mixedreality.toolkit.standardassets)
Ressources standard
Le package de ressources standard (com.microsoft.mixedreality.toolkit.standardassets) est une collection de composants recommandés pour toutes les expériences de réalité mixte, notamment :
- Nuanceur MRTK Standard
- Matériaux de base utilisant le nuanceur MRTK Standard
- Fichiers audio
- Polices
- Textures
- Icônes
Remarque
Pour éviter les changements cassants en fonction des définitions d’assembly, les scripts utilisés pour contrôler certaines fonctionnalités du nuanceur MRTK Standard ne sont pas inclus dans le package de ressources standard. Ces scripts se trouvent dans le package de base dans le MRTK/Core/Utilities/StandardShader dossier.
Dépendances : aucune
Packages d'extension
Package d’extensions facultatives (com.microsoft.mixedreality.toolkit.extensions) contient des composants supplémentaires qui étendent les fonctionnalités de MRTK.
| Dossier | Composant | Description |
|---|---|---|
| MRTK/Extensions | ||
| HandPhysicsService | Service qui ajoute la prise en charge physique aux mains articulées. | |
| LostTrackingService | Service qui simplifie la gestion de la perte de suivi sur les appareils Microsoft HoloLens. | |
| SceneTransitionService | Service qui simplifie l’ajout de transitions de scène fluide. | |
| Échantillons~ | Dossier masqué (dans l’éditeur Unity) qui contient les exemples de scènes et de ressources. |
Pour plus d’informations sur le processus d’utilisation de packages contenant des exemples de projets, consultez l’article Mixed Reality Toolkit et Unity Gestionnaire de package.
Dépendances :
- Fondation (
com.microsoft.mixedreality.toolkit.foundation)
Package d’outils
Package d’outils facultatifs (com.microsoft.mixedreality.toolkit.tools) contient des outils utiles pour la création d’expériences de réalité mixte. En règle générale, ces outils sont des composants d’éditeur et leur code n’est pas fourni dans le cadre d’une application.
| Dossier | Composant | Description |
|---|---|---|
| MRTK/Tools | ||
| BuildWindow | Outil qui permet de simplifier le processus de création et de déploiement d’applications UWP. | |
| DependencyWindow | Outil qui crée une graphe des dépendances de ressources dans un projet. | |
| ExtensionServiceCreator | Assistant pour faciliter la création de services d’extension. | |
| MigrationWindow | Outil qui aide à mettre à jour le code qui utilise des composants MRTK déconseillés. | |
| OptimizeWindow | Utilitaire permettant d’automatiser la configuration d’un projet de réalité mixte pour obtenir les meilleures performances dans Unity. | |
| ReserializeAssetsUtility | Fournit la prise en charge de la resérialisation des fichiers Unity spécifiques. | |
| RuntimeTools/Tools/ControllerMappingTool | Utilitaire permettant aux développeurs de déterminer rapidement les mappages Unity pour les contrôleurs matériels. | |
| ScreenshotUtility | Permet de capturer des images d’application dans l’éditeur Unity. | |
| TextureCombinerWindow | Utilitaire pour combiner des textures graphiques. | |
| Boîte à outils | Interface utilisateur qui facilite la découverte et l’utilisation des composants d’expérience utilisateur MRTK. |
Dépendances :
- Fondation (
com.microsoft.mixedreality.toolkit.foundation)
Package d’utilitaires de test
Le package d’utilitaires de test facultatif (com.microsoft.mixedreality.toolkit.testutilities) contient une collection de scripts d’assistance qui permettent aux développeurs de créer facilement des tests en mode lecture. Ces utilitaires sont particulièrement utiles pour les développeurs qui créent des composants MRTK.
| Dossier | Composant | Description |
|---|---|---|
| MRTK/Tests | ||
| TestUtilities | Méthodes pour simplifier la création de tests en mode lecture, y compris les utilitaires de simulation manuelle. |
Dépendances :
- Fondation (
com.microsoft.mixedreality.toolkit.foundation)
Package d’exemples
Le package d’exemples (com.microsoft.mixedreality.toolkit.examples), est structuré pour permettre aux développeurs d’importer uniquement les exemples d’intérêt.
Pour plus d’informations sur le processus d’utilisation de packages contenant des exemples de projets, consultez l’article Mixed Reality Toolkit et Unity Gestionnaire de package.
| Dossier | Composant | Description |
|---|---|---|
| MRTK/Exemples | ||
| Échantillons~ | Dossier masqué (dans l’éditeur Unity) qui contient les exemples de scènes et de ressources. | |
| StandardAssets | Ressources communes partagées par plusieurs scènes de démonstration. |
Dépendances :
- Fondation (
com.microsoft.mixedreality.toolkit.foundation) - Extensions (
com.microsoft.mixedreality.toolkit.extensions)