Actualización desde HoloToolkitUpgrading from HoloToolkit

Una guía para ayudarle con la migración de HoloLens Toolkit (HTK) a Mixed Reality Toolkit (MRTK).A guide to help you with migration from HoloLens Toolkit (HTK) to Mixed Reality Toolkit (MRTK).

Entrada de controlador y manoController and hand input

Instalación y configuraciónSetup and configuration

MétodosMethods HTK 2017HTK 2017 MRTK v2MRTK v2
TipoType Eventos específicos para botones, con información de tipo de entrada cuando sea pertinente.Specific events for buttons, with input type info when relevant. Entrada basada en acciones o gestos, que se pasa a través de eventos.Action / Gesture based input, passed along via events.
InstalaciónSetup Coloque InputManager en la escena.Place the InputManager in the scene. Habilite el sistema de entrada en el perfil de configuración y especifique un tipo de sistema de entrada concreto.Enable the input system in the Configuration Profile and specify a concrete input system type.
ConfiguraciónConfiguration Configurado en el inspector, en cada script individual de la escena.Configured in the Inspector, on each individual script in the scene. Se configura mediante el Mixed Reality del sistema de entrada y su perfil relacionado, que se enumeran a continuación.Configured via the Mixed Reality Input System Profile and its related profile, listed below.

Perfiles relacionados:Related profiles:

  • Mixed Reality de asignación de controladoresMixed Reality Controller Mapping Profile
  • Mixed Reality de visualización del controladorMixed Reality Controller Visualization Profile
  • Mixed Reality perfil de gestosMixed Reality Gestures Profile
  • Mixed Reality de acciones de entradaMixed Reality Input Actions Profile
  • Mixed Reality de reglas de acción de entradaMixed Reality Input Action Rules Profile
  • Mixed Reality de punteroMixed Reality Pointer Profile

La configuración del proveedor de mirada se modifica en el objeto Cámara principal de la escena.Gaze Provider settings are modified on the Main Camera object in the scene.

Los componentes de soporte técnico de la plataforma (por ejemplo, Windows Mixed Reality Administrador de dispositivos) deben agregarse a los proveedores de datos de sus servicios correspondientes.Platform support components (e.g., Windows Mixed Reality Device Manager) must be added to their corresponding service's data providers.

Asignaciones de interfaz y eventosInterface and event mappings

Algunos eventos ya no tienen eventos únicos y ahora contienen un MixedRealityInputAction.Some events no longer have unique events and now contain a MixedRealityInputAction. Estas acciones se especifican en el perfil Acciones de entrada y se asignan a controladores y plataformas específicos en el perfil asignación de controladores.These actions are specified in the Input Actions profile and mapped to specific controllers and platforms in the Controller Mapping profile. Eventos como OnInputDown ahora deben comprobar el tipo MixedRealityInputAction.Events like OnInputDown should now check the MixedRealityInputAction type.

Sistemas de entrada relacionados:Related input systems:

HTK 2017HTK 2017 MRTK v2MRTK v2 Asignación de accionesAction Mapping
IControllerInputHandler IMixedRealityInputHandler<Vector2> Asignado al panel táctil o al control de posiciónMapped to the touchpad or thumbstick
IControllerTouchpadHandler IMixedRealityInputHandler Asignado al panel táctilMapped to the touchpad
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Asignado para que se mantenga en el perfil de gestosMapped to hold in the Gestures Profile
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Asignado a los botones del controlador o a la pulsación con la manoMapped to the controller’s buttons or hand tap
IManipulationHandler IMixedRealityGestureHandler<Vector3> Asignado a la manipulación en el perfil de gestosMapped to manipulation in the Gestures Profile
INavigationHandler IMixedRealityGestureHandler<Vector3> Asignado a la navegación en el perfil de gestosMapped to navigation in the Gestures Profile
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Asignado a la posición del desencadenadorMapped to trigger position
ISourcePositionHandler IMixedRealityInputHandler<Vector3> o IMixedRealityInputHandler<MixedRealityPose>IMixedRealityInputHandler<Vector3> or IMixedRealityInputHandler<MixedRealityPose> Asignado a la posición del puntero o a la posición del controlMapped to pointer position or grip position
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> o IMixedRealityInputHandler<MixedRealityPose>IMixedRealityInputHandler<Quaternion> or IMixedRealityInputHandler<MixedRealityPose> Asignado a la posición del puntero o a la posición del controlMapped to pointer position or grip position
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler y IMixedRealityInputHandler<Vector2>IMixedRealityInputHandler and IMixedRealityInputHandler<Vector2> Asignado a los distintos botones y botones de controladorMapped to the various controller buttons and thumbsticks

CámaraCamera

MétodosMethods HTK 2017HTK 2017 MRTK v2MRTK v2
InstalaciónSetup Elimine MainCamera, agregue MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera prefab a la escena o use Mixed Reality Toolkit > configurar > aplicar Mixed Reality escena Configuración elemento de menú. Delete MainCamera, add MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera prefab to scene or use Mixed Reality Toolkit > Configure > Apply Mixed Reality Scene Settings menu item. MainCamera primario en MixedRealityPlayspace a través Mixed Reality Toolkit > agregar a la escena y configurar...MainCamera parented under MixedRealityPlayspace via Mixed Reality Toolkit > Add to Scene and Configure...
ConfiguraciónConfiguration Configuración de la cámara realizada en la instancia prefab.Camera settings configuration performed on prefab instance. Configuración de la cámara configurada en el Cámara de realidad mixta perfil.Camera settings configured in the Mixed Reality Camera Profile.

VozSpeech

Reconocimiento de palabras claveKeyword recognition

MétodosMethods HTK 2017HTK 2017 MRTK v2MRTK v2
InstalaciónSetup Agregue un speechInputSource a la escena.Add a SpeechInputSource to your scene. El servicio keyword (por ejemplo, Windows Speech Input Manager) debe agregarse a los proveedores de datos del sistema de entrada.Keyword service (e.g., Windows Speech Input Manager) must be added to the input system's data providers.
ConfiguraciónConfiguration Las palabras clave reconocidas se configuran en el inspector de SpeechInputSource.Recognized keywords are configured in the SpeechInputSource’s inspector. Las palabras clave se configuran en el Mixed Reality de comandos de voz.Keywords are configured in the Mixed Reality Speech Commands Profile.
Controladores de eventosEvent handlers ISpeechHandler IMixedRealitySpeechHandler

DictadoDictation

MétodosMethods HTK 2017HTK 2017 MRTK v2MRTK v2
InstalaciónSetup Agregue una instancia de DictationInputManager a la escena.Add a DictationInputManager to your scene. La compatibilidad con dictado requiere que el servicio (por ejemplo, Windows de entrada de dictado) se agrega a los proveedores de datos del sistema de entrada.Dictation support requires service (e.g., Windows Dictation Input Manager) to be added to the Input System's data providers.
Controladores de eventosEvent handlers IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Reconocimiento espacial/asignaciónSpatial awareness / mapping

En mallaMesh

MétodosMethods HTK 2017HTK 2017 MRTK v2MRTK v2
InstalaciónSetup Agregue el objeto prefab SpatialMapping a la escena.Add the SpatialMapping prefab to the scene. Habilite el sistema de reconocimiento espacial en el perfil de configuración y agregue un observador espacial (por ejemplo, Windows Mixed Reality Observador de malla espacial) a los proveedores de datos del sistema de reconocimiento espacial.Enable the Spatial Awareness System in the Configuration Profile and add a spatial observer (e.g., Windows Mixed Reality Spatial Mesh Observer) to the Spatial Awareness System's data providers.
ConfiguraciónConfiguration Configure la instancia de escena en el inspector.Configure the scene instance in the inspector. Configure los valores en el perfil de cada observador espacial.Configure the settings on each spatial observer's profile.

AvionesPlanes

MétodosMethods HTK 2017HTK 2017 MRTK v2MRTK v2
InstalaciónSetup Use el SurfaceMeshesToPlanes script.Use the SurfaceMeshesToPlanes script. Sin implementar todavía.Not yet implemented.

Comprensión espacialSpatial understanding

MétodosMethods HTK 2017HTK 2017 MRTK v2MRTK v2
InstalaciónSetup Agregue el objeto prefab SpatialUnderstanding a la escena.Add the SpatialUnderstanding prefab to the scene. Sin implementar todavía.Not yet implemented.
ConfiguraciónConfiguration Configure la instancia de escena en el inspector.Configure the scene instance in the inspector. Sin implementar todavía.Not yet implemented.

LímiteBoundary

MétodosMethods HTK 2017HTK 2017 MRTK v2MRTK v2
InstalaciónSetup Agregue el BoundaryManager script a la escena.Add the BoundaryManager script to the scene. Habilite el sistema de límites en el perfil de configuración.Enable the Boundary System in the Configuration Profile.
ConfiguraciónConfiguration Configure la instancia de escena en el inspector.Configure the scene instance in the inspector. Configure los valores en el perfil Visualización de límites.Configure the settings in the Boundary Visualization profile.

Uso compartidoSharing

MétodosMethods HTK 2017HTK 2017 MRTK v2MRTK v2
InstalaciónSetup Servicio de uso compartido: agregue el prefab Uso compartido a la escena.Sharing service: Add Sharing prefab to the scene. UNet: use el ejemplo SharingWithUNET.UNet: Use SharingWithUNET example. En cursoIn-progress
ConfiguraciónConfiguration Configure las instancias de escena en el inspector.Configure the scene instances in the inspector. En cursoIn-progress

Experiencia de usuarioUX

MétodosMethods HTK 2017HTK 2017 MRTK v2MRTK v2
BotónButton Objetos interactuablesInteractable Objects BotónButton
InteractuableInteractable Objetos interactuablesInteractable Objects InteractuableInteractable
Cuadro de límiteBounding Box Rectángulo de selecciónBounding Box Rectángulo de selecciónBounding Box
Barra de la aplicaciónApp Bar Barra de aplicacionesApp Bar Barra de aplicacionesApp Bar
Manipulación con una mano (Grb y Move)One Hand Manipulation (Grb and Move) HandDraggableHandDraggable Controlador de manipulaciónManipulation Handler
Manipulación de dos manos (agarrar, mover, girar o escalar)Two Hand Manipulation (Grab/Move/Rotate/Scale) TwoHandManipulatableTwoHandManipulatable Controlador de manipulaciónManipulation Handler
TecladoKeyboard Prefab de tecladoKeyboard prefab Teclado del sistemaSystem Keyboard
Información sobre herramientasTooltip Información sobre herramientasTooltip Información sobre herramientasTooltip
Colección de objetosObject Collection Colección de objetosObject Collection Colección de objetosObject Collection
SolverSolver SolverSolver SolverSolver

UtilidadesUtilities

Algunas utilidades se han conciliado como duplicados con el sistema solver.Some Utilities have been reconciled as duplicates with the Solver system. Si falta alguno de los scripts que necesita, envíe un problema.Please file an issue if any of the scripts you need are missing.

HTK 2017HTK 2017 MRTK v2MRTK v2
CarteleraBillboard Billboard
TagalongTagalong RadialView o Orbital SolucionadorRadialView or Orbital Solver
FixedAngularSizeFixedAngularSize ConstantViewSizeSolucionadorConstantViewSize Solver
FpsDisplayFpsDisplay Sistema de diagnóstico (en el perfil de configuración)Diagnostics System (in Configuration Profile)
NearFadeNearFade Integrado en el sombreador Mixed Reality Toolkit estándarBuilt-in to Mixed Reality Toolkit Standard shader