Share via

Mise à niveau à partir de HoloToolkit — MRTK2

  • Article

Guide pour vous aider à migrer de HoloLens Toolkit (HTK) vers Mixed Reality Toolkit (MRTK).

Contrôleur et entrée manuelle

Installation et configuration

Méthodes HTK 2017 MRTK v2
Type Événements spécifiques pour les boutons, avec des informations de type d’entrée le cas échéant. Entrée basée sur l’action/le mouvement, transmise via des événements.
Programme d’installation Placez l’inputManager dans la scène. Activez le système d’entrée dans le profil de configuration et spécifiez un type de système d’entrée concret.
Configuration Configuré dans l’inspecteur, sur chaque script individuel de la scène. Configuré via le profil système d’entrée Mixed Reality et son profil associé, répertoriés ci-dessous.

Profils associés :

  • profil de mappage de contrôleur Mixed Reality
  • profil de visualisation du contrôleur Mixed Reality
  • profil de mouvements Mixed Reality
  • profil d’actions d’entrée Mixed Reality
  • profil des règles d’action d’entrée Mixed Reality
  • profil de pointeur Mixed Reality

Les paramètres du fournisseur de vue sont modifiés sur l’objet Main Camera dans la scène.

Les composants de prise en charge de la plateforme (par exemple, Windows Mixed Reality Gestionnaire de périphériques) doivent être ajoutés aux fournisseurs de données de leur service correspondant.

Mappages d’interface et d’événements

Certains événements n’ont plus d’événements uniques et contiennent désormais un MixedRealityInputAction. Ces actions sont spécifiées dans le profil Actions d’entrée et mappées à des contrôleurs et plateformes spécifiques dans le profil Mappage du contrôleur. Les événements tels que OnInputDown doivent maintenant case activée le type MixedRealityInputAction.

Systèmes d’entrée associés :

HTK 2017 MRTK v2 Mappage d’actions
IControllerInputHandler IMixedRealityInputHandler<Vector2> Mappé au pavé tactile ou au bâton
IControllerTouchpadHandler IMixedRealityInputHandler Mappé au pavé tactile
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Mappé pour conserver dans le profil de mouvements
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Mappé aux boutons du contrôleur ou appuyez sur la main
IManipulationHandler IMixedRealityGestureHandler<Vector3> Mappé à la manipulation dans le profil de mouvements
INavigationHandler IMixedRealityGestureHandler<Vector3> Mappé à la navigation dans le profil de mouvements
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Mappé à la position du déclencheur
ISourcePositionHandler IMixedRealityInputHandler<Vector3> ou IMixedRealityInputHandler<MixedRealityPose> Mappé à la position du pointeur ou de la prise en main
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> ou IMixedRealityInputHandler<MixedRealityPose> Mappé à la position du pointeur ou de la prise en main
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler et IMixedRealityInputHandler<Vector2> Mappé aux différents boutons et bâtons de commande du contrôleur

Appareil photo

Méthodes HTK 2017 MRTK v2
Programme d’installation Supprimez MainCamera, ajoutez MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera préfabriqué à la scène ou utilisez Mixed Reality Toolkit > Configure Configure > Apply Mixed Reality Scene Settings. MainCamera parentée sous MixedRealityPlayspace via Mixed Reality Toolkit > Ajouter à la scène et configurer...
Configuration Configuration des paramètres de l’appareil photo effectuée sur le préfabriqué instance. Paramètres de l’appareil photo configurés dans le profil d’appareil photo Mixed Reality.

Voix

Reconnaissance de mot clé

Méthodes HTK 2017 MRTK v2
Programme d’installation Ajoutez un Objet SpeechInputSource à votre scène. Le service de mots clés (par exemple, Windows Speech Input Manager) doit être ajouté aux fournisseurs de données du système d’entrée.
Configuration Les mots clés reconnus sont configurés dans l’inspecteur de SpeechInputSource. Les mots clés sont configurés dans le profil de commandes vocales Mixed Reality.
Gestionnaires d’événements ISpeechHandler IMixedRealitySpeechHandler

Dictation

Méthodes HTK 2017 MRTK v2
Programme d’installation Ajoutez un DictationInputManager à votre scène. La prise en charge de la dictée nécessite l’ajout d’un service (par exemple, le Gestionnaire d’entrée de dictée Windows) aux fournisseurs de données du système d’entrée.
Gestionnaires d’événements IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Reconnaissance spatiale/mappage

Maillage

Méthodes HTK 2017 MRTK v2
Programme d’installation Ajoutez le préfabriqué SpatialMapping à la scène. Activez le système de reconnaissance spatiale dans le profil de configuration et ajoutez un observateur spatial (par exemple, Windows Mixed Reality Spatial Mesh Observer) aux fournisseurs de données du système de reconnaissance spatiale.
Configuration Configurez la scène instance dans l’inspecteur. Configurez les paramètres sur le profil de chaque observateur spatial.

Avions

Méthodes HTK 2017 MRTK v2
Programme d’installation Utilisez le SurfaceMeshesToPlanes script. Pas encore implémenté.

Compréhension spatiale

Méthodes HTK 2017 MRTK v2
Programme d’installation Ajoutez le préfabriqué SpatialUnderstanding à la scène. Pas encore implémenté.
Configuration Configurez la scène instance dans l’inspecteur. Pas encore implémenté.

Limite

Méthodes HTK 2017 MRTK v2
Programme d’installation Ajoutez le BoundaryManager script à la scène. Activez le système de limites dans le profil de configuration.
Configuration Configurez la scène instance dans l’inspecteur. Configurez les paramètres dans le profil de visualisation des limites.

Partage

Méthodes HTK 2017 MRTK v2
Programme d’installation Service de partage : ajoutez le préfabriqué de partage à la scène. UNet : utiliser l’exemple SharingWithUNET. En cours
Configuration Configurez les instances de scène dans l’inspecteur. En cours

UX

Méthodes HTK 2017 MRTK v2
Bouton Objets interagissants Button
Avec interaction Objets interagissants Avec interaction
Cadre englobant Cadre englobant Cadre englobant
Barre d’application Barre d’application Barre d’application
Manipulation d’une main (Grb et Move) HandDraggable Gestionnaire de manipulation
Manipulation à deux mains (saisir/déplacer/faire pivoter/mettre à l’échelle) TwoHandManipulatable Gestionnaire de manipulation
Clavier Préfabriqué clavier Clavier système
Info-bulle Info-bulle Info-bulle
Collection d’objets Collection d’objets Collection d’objets
Solver Solver Solver

Services

Certains utilitaires ont été rapprochés en tant que doublons avec le système solveur. Signalez un problème si l’un des scripts dont vous avez besoin est manquant.

HTK 2017 MRTK v2
Billboard Billboard
Tagalong RadialView ou OrbitalSolveur
FixedAngularSize ConstantViewSizeSolveur
FpsDisplay Système de diagnostics (dans le profil de configuration)
NearFade Nuanceur standard intégré à Mixed Reality Toolkit