Lire en anglais

Partager via


MRTK packages — MRTK2

Mixed Reality Toolkit (MRTK) est un ensemble de packages qui permettent le développement d’applications Mixed Reality multiplateformes en prenant en charge le matériel et les plateformes Mixed Reality.

MRTK est disponible en tant que packages multimédias (.unitypackage) et via le gestionnaire de package Unity.

Packages de ressources

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-uns des défis à relever :

  • MRTK fait partie du dossier Assets du projet, ce qui conduit à
    • Projets plus volumineux
    • Temps de compilation plus lents
  • Aucune gestion des dépendances
    • Les clients doivent résoudre les dépendances de package manuellement
  • Processus de mise à jour manuelle
    • Plusieurs étapes
    • Mises à jour de contrôle de code source volumineuses (plus de 3 000 fichiers)
    • Risque de perdre les modifications apportées à MRTK
  • L’importation du package d’exemples implique généralement d’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

La 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 dela fondation Pakage

Le package MRTK Foundation contient les éléments suivants.

Folder 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 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 des entrées manuelles et oculaires.
ObjectMeshObserver Observateur de la reconnaissance spatiale utilisant un modèle 3D comme données.
UnityInput Périphériques 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 Leap Motion UltraLeap.
OpenVR Prise en charge des appareils OpenVR.
Oculus Prise en charge des appareils Oculus, tels que quest.
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, y compris les casques Microsoft HoloLens et 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 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 Prise en charge des limites vr implémentant le système.
CameraSystem Système implémentant la configuration et la gestion de la caméra.
DiagnosticsSystem L’implémentation du 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 à 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 MRTK Standard nuanceur, 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.

Note

Le package d’extensions nécessite Microsoft.MixedRealityToolkit.Unity.Foundation.

Folder Composant Description
MRTK/Extensions
HandPhysicsService Service qui ajoute la prise en charge de la 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ène sans heurts.

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 le Rédacteur Unity.

Note

Le package d’outils nécessite Microsoft.MixedRealityToolkit.Unity.Foundation.

Folder 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 un 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éconseillés.
OptimizeWindow Utilitaire permettant d’automatiser la configuration d’un projet de réalité mixte pour obtenir des performances optimales dans Unity.
ReserializeAssetsUtility Fournit la prise en charge de 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.
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 UX 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.

Folder Composant Description
MRTK/Tests
TestUtilities Méthodes pour simplifier la création de tests en mode lecture, y compris les utilitaires de simulation manuelle.

Exemples de package

Le package d’exemples contient des démonstrations, des exemples de scripts et des exemples de scènes qui exercent la fonctionnalité dans le package de base. Ce package contient la scène HandInteractionExample (image ci-dessous) qui contient des exemples d’objets qui répondent à différents types d’entrée manuelle (articulée et non articulée).

Scène HandInteractionExample

Ce package contient également des démonstrations de suivi oculaire, qui sont documentées ici

Plus généralement, toute nouvelle fonctionnalité dans 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.

Note

Le package d’exemples nécessite Microsoft.MixedRealityToolkit.Unity.Foundation.

Folder Composant Description
MRTK/Exemples
Démonstrations Scènes simples illustrant une ou deux caractéristiques 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 de ressources :

  • Projets plus petits
    • Solutions Visual Studio plus propres
    • Moins de fichiers à case activée (MRTK est une référence simple dans le Packages/manifest.json fichier)
  • 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.json fichier

Voici quelques-uns des défis à relever :

  • MRTK est immuable
    • Impossible d’apporter des modifications sans les supprimer pendant 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.

Folder 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 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 des entrées manuelles et oculaires.
ObjectMeshObserver Observateur de la reconnaissance spatiale utilisant un modèle 3D comme données.
UnityInput Périphériques 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 Leap Motion UltraLeap.
OpenVR Prise en charge des appareils OpenVR.
Oculus Prise en charge des appareils Oculus, tels que quest.
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, y compris les casques Microsoft HoloLens et 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 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 Prise en charge des limites vr implémentant le système.
CameraSystem Système implémentant la configuration et la gestion de la caméra.
DiagnosticsSystem L’implémentation du 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 à 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 de Standard MRTK
  • Matériaux de base utilisant le nuanceur Standard MRTK
  • Fichiers audio
  • Polices
  • Textures
  • Icônes

Note

Pour éviter les modifications cassants basées sur les 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

Le package d’extensions facultatives (com.microsoft.mixedreality.toolkit.extensions) contient des composants supplémentaires qui étendent les fonctionnalités de MRTK.

Folder Composant Description
MRTK/Extensions
HandPhysicsService Service qui ajoute la prise en charge de la physique aux mains articulées.
LostTrackingService Service qui simplifie la remise du suivi des pertes sur les appareils Microsoft HoloLens.
SceneTransitionService Service qui simplifie l’ajout de transitions de scène sans heurts.
Échantillons~ Un dossier masqué (dans unity Rédacteur) 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 d’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.

Folder 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 un 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éconseillés.
OptimizeWindow Utilitaire permettant d’automatiser la configuration d’un projet de réalité mixte pour obtenir des performances optimales dans Unity.
ReserializeAssetsUtility Fournit la prise en charge de 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.
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 UX 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.

Folder 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)

Exemples de package

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 Unity Package Manager.

Folder Composant Description
MRTK/Exemples
Échantillons~ Un dossier masqué (dans unity Rédacteur) 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)

Voir aussi