MRTK packages — MRTK2
Mixed Reality Toolkit (MRTK) est une collection de packages qui permettent le développement d’applications multiplateformes Mixed Reality en prenant en charge Mixed Reality matériel et plateformes.
MRTK est disponible en tant que packages d’actifs (.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 de ressources :
- Disponible pour Unity 2018.4 et versions ultérieures
- Modification facile de MRTK
- MRTK se trouve dans le dossier Assets
Voici quelques-unes des difficultés :
- MRTK fait partie du dossier Assets du projet, ce qui conduit à
- Grands projets
- 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 (plus de 3 000 fichiers)
- Risque de perdre les modifications apportées à MRTK
- Importer le 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 De base
Le Mixed Reality Toolkit Foundation est l’ensemble de code qui permet à votre application de tirer parti des fonctionnalités courantes sur Mixed Reality plateformes.
Package de fondation MRTK Pakage foundation
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 la classe de base pour le suivi de la main. | |
| InputAnimation | Prise en charge de l’enregistrement des données de déplacement de la tête et de suivi de la main. | |
| InputSimulation | Prise en charge de la simulation dans l’éditeur de l’entrée manuelle et oculaire. | |
| ObjectMeshObserver | Observateur de la conscience spatiale utilisant un modèle 3D comme données. | |
| UnityInput | Appareils d’entrée courants (joystick, souris, etc.) implémentés via l’API d’entrée d’Unity. | |
| MRTK/Fournisseurs | 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 appareils Oculus, tels que Quest. | |
| UnityAR | (Expérimental) Fournisseur de paramètres d’appareil photo permettant l’utilisation de MRTK avec des appareils ar mobiles. | |
| WindowsMixedReality | Prise en charge des appareils Windows Mixed Reality, y compris les casques Microsoft HoloLens et immersifs. | |
| Windows | Prise en charge des API spécifiques à Microsoft Windows, par exemple la parole 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 système individuels. | |
| Fonctionnalités | Fonctionnalité qui s’appuie sur le package Foundation. | |
| Profils | 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 système dans l’application diagnostics, 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 la prise en charge des applications multi-scènes. | |
| SpatialAwarenessSystem | Système fournissant la prise en charge de la sensibilisation de l’environnement de l’utilisateur. | |
| TeleportSystem | Système fournissant la prise en charge de la téléportation (déplacement de l’expérience dans les 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.
Notes
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 du suivi des pertes sur les appareils Microsoft HoloLens. | |
| SceneTransitionService | Service qui simplifie l’ajout de transitions de scènes fluides. |
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.
Notes
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épréciés. | |
| OptimizeWindow | Utilitaire permettant d’automatiser la configuration d’un projet de réalité mixte pour obtenir de meilleures performances dans Unity. | |
| ReserializeAssetsUtility | Prend en charge la resérialisation de 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. |
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 de jeu, 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ées manuelles (articulées et non articulées).
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, en suivant à peu près la même structure de dossiers et le même emplacement.
Notes
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 associées. | |
| 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’actifs :
- Projets plus petits
- Solutions Visual Studio plus propres
- Moins de fichiers à case activée (MRTK est une simple référence 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 vers les 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 les supprimer lors de la résolution du package
- MRTK ne prend pas en charge les packages UPM avec Unity 2018.4
Package De base
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épendantes de la plateforme | |
| Mains | Prise en charge de la classe de base et services pour le suivi de la main. | |
| InputAnimation | Prise en charge de l’enregistrement des données de déplacement de la tête et de suivi de la main. | |
| InputSimulation | Prise en charge de la simulation dans l’éditeur de l’entrée de la main et de l’œil. | |
| ObjectMeshObserver | Observateur de la reconnaissance spatiale utilisant un modèle 3D comme données. | |
| UnityInput | Périphériques d’entrée courants (manette de jeu, souris, etc.) implémentés via l’API d’entrée d’Unity. | |
| MRTK/Fournisseurs | 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 appareils Oculus, tels que Quest. | |
| UnityAR | (Expérimental) Fournisseur de paramètres d’appareil photo permettant l’utilisation de MRTK avec des appareils ar mobiles. | |
| WindowsMixedReality | Prise en charge des appareils Windows Mixed Reality, y compris les casques Microsoft HoloLens et immersifs. | |
| Windows | Prise en charge des API spécifiques à Microsoft Windows, par exemple la parole 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 système individuels. | |
| Fonctionnalités | Fonctionnalité qui s’appuie sur le package Foundation. | |
| Profils | 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 système dans l’application diagnostics, 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 la prise en charge des applications multi-scènes. | |
| SpatialAwarenessSystem | Système fournissant la prise en charge de la sensibilisation de l’environnement de l’utilisateur. | |
| TeleportSystem | Système fournissant la prise en charge de la téléportation (déplacement de l’expérience dans les 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
- Fonts
- Textures
- Icônes
Notes
Pour éviter les modifications 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 du MRTK/Core/Utilities/StandardShader dossier.
Dépendances : aucune
Packages d'extension
Le 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 de la physique aux mains articulées. | |
| LostTrackingService | Service qui simplifie la distribution de la perte de suivi sur Microsoft HoloLens appareils. | |
| SceneTransitionService | Service qui simplifie l’ajout de transitions de scènes fluides. | |
| É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 Package Manager.
Dépendances :
- Fondation (
com.microsoft.mixedreality.toolkit.foundation)
Package Outils
Le package d’outils facultatifs (com.microsoft.mixedreality.toolkit.tools) contient des outils utiles pour créer des expériences de réalité mixte. En général, 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 simplifie le processus de création et de déploiement d’applications UWP. | |
| DépendanceWindow | Outil qui crée une graphe des dépendances de ressources dans un projet. | |
| ExtensionServiceCreator | Assistant pour aider à créer des services d’extension. | |
| MigrationWindow | Outil qui aide à mettre à jour le code qui utilise des composants MRTK dépréciés. | |
| OptimiserWindow | Utilitaire permettant d’automatiser la configuration d’un projet de réalité mixte pour obtenir les meilleures performances dans Unity. | |
| ReserializeAssetsUtility | Prend en charge la resérialisation de 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 de jeu, 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 intéressants.
Pour plus d’informations sur le processus d’utilisation de packages contenant des exemples de projets, consultez l’article Mixed Reality Toolkit et le Gestionnaire de package Unity.
| Dossier | Composant | Description |
|---|---|---|
| MRTK/Exemples | ||
| Échantillons~ | Un 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)