Compartir a través de

Actualización desde HoloToolkit: MRTK2

  • Artículo

Guía para ayudarle con la migración de HoloLens Toolkit (HTK) a Mixed Reality Toolkit (MRTK).

Controlador y entrada de mano

Instalación y configuración

Métodos HTK 2017 MRTK versión 2
Tipo Eventos específicos para botones, con información de tipo de entrada cuando sea pertinente. Entrada basada en acciones o gestos, que se pasa a través de eventos.
Configurar Coloque el InputManager en la escena. Habilite el sistema de entrada en el perfil de configuración y especifique un tipo de sistema de entrada concreto.
Configuración Configurado en el Inspector, en cada script individual de la escena. Configurado a través del perfil del sistema de entrada de Mixed Reality y su perfil relacionado, que se muestra a continuación.

Perfiles relacionados:

  • Perfil de asignación de controladores de Mixed Reality
  • Perfil de visualización del controlador de realidad mixta
  • Perfil de gestos de realidad mixta
  • Perfil de acciones de entrada de realidad mixta
  • Perfil de reglas de acción de entrada de Mixed Reality
  • Perfil de puntero de realidad mixta

La configuración del proveedor de miradas se modifica en el objeto Cámara principal de la escena.

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.

Asignaciones de interfaz y eventos

Algunos eventos ya no tienen eventos únicos y ahora contienen mixedRealityInputAction. Estas acciones se especifican en el perfil De acciones de entrada y se asignan a controladores y plataformas específicos en el perfil de asignación de controladores. Los eventos como OnInputDown ahora deben comprobar el tipo MixedRealityInputAction.

Sistemas de entrada relacionados:

HTK 2017 MRTK versión 2 Asignación de acciones
IControllerInputHandler IMixedRealityInputHandler<Vector2> Asignado al panel táctil o al stick deslizante
IControllerTouchpadHandler IMixedRealityInputHandler Asignado al panel táctil
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Asignado para mantener en el perfil de gestos
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Asignado a los botones del controlador o pulsación manual
IManipulationHandler IMixedRealityGestureHandler<Vector3> Asignado a la manipulación en el perfil de gestos
INavigationHandler IMixedRealityGestureHandler<Vector3> Asignado a la navegación en el perfil de gestos
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Asignado a la posición del desencadenador
ISourcePositionHandler IMixedRealityInputHandler<Vector3> o IMixedRealityInputHandler<MixedRealityPose> Asignado a la posición del puntero o a la posición de agarre
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> o IMixedRealityInputHandler<MixedRealityPose> Asignado a la posición del puntero o a la posición de agarre
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler y IMixedRealityInputHandler<Vector2> Asignado a los distintos botones del controlador y los sticks de control

Camera

Métodos HTK 2017 MRTK versión 2
Configurar Elimine MainCamera, agregue mixedRealityCameraParent / MixedRealityCamera / HoloLensCamera prefab to scene or use Mixed Reality Toolkit Configure Apply Mixed Reality Scene Settings (Configurar > mixed Reality Scene > Settings). MainCamera primario en MixedRealityPlayspace a través de Mixed Reality Toolkit > Add to Scene and Configure...
Configuración Configuración de la cámara realizada en la instancia prefabricada. Configuración de la cámara configurada en el perfil de cámara de Mixed Reality.

Voz

Reconocimiento de palabras clave

Métodos HTK 2017 MRTK versión 2
Configurar Agregue speechInputSource a la escena. El servicio de palabras clave (por ejemplo, Administrador de entrada de voz de Windows) debe agregarse a los proveedores de datos del sistema de entrada.
Configuración Las palabras clave reconocidas se configuran en el inspector de SpeechInputSource. Las palabras clave se configuran en el perfil de comandos de voz de Mixed Reality.
Controladores de eventos ISpeechHandler IMixedRealitySpeechHandler

Dictado

Métodos HTK 2017 MRTK versión 2
Configurar Agregue un DictationInputManager a la escena. La compatibilidad con dictado requiere que el servicio (por ejemplo, administrador de entrada de dictado de Windows) se agregue a los proveedores de datos del sistema de entrada.
Controladores de eventos IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Reconocimiento espacial y asignación

En malla

Métodos HTK 2017 MRTK versión 2
Configurar Agregue el objeto prefabricado SpatialMapping a la escena. Habilite el sistema de reconocimiento espacial en el perfil de configuración y agregue un observador espacial (por ejemplo, El observador de malla espacial de Windows Mixed Reality) a los proveedores de datos del sistema de reconocimiento espacial.
Configuración Configure la instancia de escena en el inspector. Configure los valores en el perfil de cada observador espacial.

Aviones

Métodos HTK 2017 MRTK versión 2
Configurar Use el SurfaceMeshesToPlanes script. No implementado todavía.

Comprensión espacial

Métodos HTK 2017 MRTK versión 2
Configurar Agregue el objeto prefabricado SpatialUnderstanding a la escena. No implementado todavía.
Configuración Configure la instancia de escena en el inspector. No implementado todavía.

Límite

Métodos HTK 2017 MRTK versión 2
Configurar Agregue el BoundaryManager script a la escena. Habilite el sistema de límites en el perfil de configuración.
Configuración Configure la instancia de escena en el inspector. Configure los valores en el perfil De visualización de límites.

Uso compartido

Métodos HTK 2017 MRTK versión 2
Configurar Servicio de uso compartido: agregue prefabricado de uso compartido a la escena. UNet: use el ejemplo sharingWithUNET. En curso
Configuración Configure las instancias de escena en el inspector. En curso

Experiencia de usuario

Métodos HTK 2017 MRTK versión 2
Botón Objetos interactables Botón
Interactuable Objetos interactables Interactable
Cuadro de límite Rectángulo de selección Rectángulo de selección
Barra de la aplicación Barra de aplicaciones Barra de aplicaciones
Manipulación de una mano (grb y movimiento) HandDraggable Controlador de manipulación
Manipulación de dos manos (agarre, movimiento, rotación y escala) TwoHandManipulatable Controlador de manipulación
Teclado Prefabricado de teclado Teclado del sistema
Información sobre herramientas Tooltip Tooltip
Colección de objetos Colección de objetos Colección de objetos
Solver Solver Solver

Utilidades

Algunas utilidades se han reconciliado como duplicados con el sistema Solver. Presente un problema si falta alguno de los scripts que necesita.

HTK 2017 MRTK versión 2
Cartelera Billboard
Tagalong RadialView o Orbital Solver
FixedAngularSize ConstantViewSizeSolucionador
FpsDisplay Sistema de diagnóstico (en perfil de configuración)
NearFade Sombreador estándar integrado en Mixed Reality Toolkit