Partager via


Mise à niveau à partir de HoloToolkit — MRTK2

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 en cas de pertinence. Entrée basée sur l’action/mouvement, transmise par le biais d’événements.
Programme d’installation Placez InputManager dans la scène. Activez le système d’entrée dans le profil de configuration et spécifiez un type concret de système d’entrée.
Configuration Configuré dans l’inspecteur, sur chaque script individuel de la scène. Configuré via le profil système d’entrée de réalité mixte et son profil associé, répertoriés ci-dessous.

Profils connexes :

  • Profil de mappage de contrôleur de réalité mixte
  • Profil de visualisation du contrôleur de réalité mixte
  • Profil des mouvements de réalité mixte
  • Profil d’actions d’entrée de réalité mixte
  • Profil de règles d’action d’entrée de réalité mixte
  • Profil de pointeur de réalité mixte

Les paramètres du fournisseur de regard sont modifiés sur l’objet Caméra principale de 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 de mappage de contrôleur. Les événements comme ceux-ci OnInputDown doivent maintenant vérifier 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 stick
IControllerTouchpadHandler IMixedRealityInputHandler Mappé au pavé tactile
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Mappé pour contenir le profil de mouvements
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Mappée aux boutons du contrôleur ou appuyez à 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 à la position de prise en main
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> ou IMixedRealityInputHandler<MixedRealityPose> Mappé à la position du pointeur ou à la position de prise en main
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler et IMixedRealityInputHandler<Vector2> Mappé aux différents boutons de contrôleur et aux bâtons de pouce

Appareil photo

Méthodes HTK 2017 MRTK v2
Programme d’installation Supprimez MainCamera, ajoutez MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera prefab sur scène ou utilisez l’élément > de menu Appliquer les paramètres de scène de réalité mixte.> MainCamera parenté sous MixedRealityPlayspace via Mixed Reality Toolkit > Add to Scene and Configure...
Configuration Configuration des paramètres de l’appareil photo effectuée sur l’instance de préfab. Paramètres de l’appareil photo configurés dans le profil de caméra de réalité mixte.

Speech

Reconnaissance de mot clé

Méthodes HTK 2017 MRTK v2
Programme d’installation Ajoutez un 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 speechInputSource. Les mots clés sont configurés dans le profil de commandes Speech de réalité mixte.
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 du service (par exemple, windows Dictée Input Manager) 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 sensibilisation 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 sensibilisation spatiale.
Configuration Configurez l’instance de scène dans l’inspecteur. Configurez les paramètres sur le profil de chaque observateur spatial.

Planes

Méthodes HTK 2017 MRTK v2
Programme d’installation Utilisez le SurfaceMeshesToPlanes script. Pas encore mis en œuvre.

Compréhension spatiale

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

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 l’instance de scène dans l’inspecteur. Configurez les paramètres dans le profil 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 Interagissant
Cadre englobant Cadre englobant Cadre englobant
Barre d’application Barre d’application Barre d’application
Manipulation d’une main (grb et déplacement) 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
Tooltip Info-bulle Info-bulle
Collection d’objets Collection d’objets Collection d’objets
Solver Solver Solver

Services

Certains utilitaires ont été réconciliés comme des doublons avec le système solveur. Envoyez un problème si l’un des scripts dont vous avez besoin est manquant.

HTK 2017 MRTK v2
Panneau d'affichage Billboard
Tagalong RadialView ou Orbital solveur
FixedAngularSize ConstantViewSizeRésolveur
FpsDisplay Système de diagnostics (dans le profil de configuration)
NearFade Nuanceur Standard intégré à Mixed Reality Toolkit