Actualización desde HoloToolkit: MRTK2

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

Entrada de controlador y 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 y 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 enumeran a continuación.

Perfiles relacionados:

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

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

Los componentes de soporte técnico de la plataforma (por ejemplo, Windows Mixed Reality Administrador de dispositivos) se deben agregar a los proveedores de datos de sus servicios correspondientes.

Asignaciones de eventos y interfaz

Algunos eventos ya no tienen eventos únicos y ahora contienen mixedRealityInputAction. Estas acciones se especifican en el perfil 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 pulgar
IControllerTouchpadHandler IMixedRealityInputHandler Asignado al panel táctil
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Asignado para mantenerse 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 y sticks del controlador

Cámara

Métodos HTK 2017 MRTK versión 2
Configurar Elimine MainCamera, agregue el objeto prefabricado MixedRealityCamera/ MixedRealityCamera o HoloLensCamera a la escena o use Mixed Reality Toolkit > Configurar > aplicar Mixed Reality elemento de menú escena Configuración. MainCamera primaria en MixedRealityPlayspace a través de Mixed Reality Toolkit > Agregar a escena y configurar...
Configuración Cámara configuración realizada en la instancia de objeto prefabricado. Cámara opciones configuradas en el perfil de Mixed Reality Cámara.

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, Windows Speech Input Manager) 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, Windows Administrador de entrada de dictado) se agregue a los proveedores de datos del sistema de entrada.
Controladores de eventos IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Reconocimiento espacial/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, Windows Mixed Reality spatial Mesh Observer) a los proveedores de datos del Sistema de reconocimiento espacial.
Configuración Configure la instancia de escena en el inspector. Configure las opciones en el perfil de cada observador espacial.

Aviones

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

Comprensión espacial

Métodos HTK 2017 MRTK versión 2
Configurar Agregue el objeto prefabricado SpatialUnderstanding a la escena. Sin implementar todavía.
Configuración Configure la instancia de escena en el inspector. Sin implementar 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 el objeto prefabricado Sharing 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 interactivos Botón
Interactuable Objetos interactivos Interactuable
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/Escala) TwoHandManipulatable Controlador de manipulación
Keyboard Objeto prefabricado de teclado Teclado del sistema
Información sobre herramientas Información sobre herramientas Información sobre herramientas
Colección de objetos Colección de objetos Colección de objetos
Solver Solver Solver

Sectores públicos

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

HTK 2017 MRTK versión 2
Cartelera Billboard
Tagalong RadialView o OrbitalSolver
FixedAngularSize ConstantViewSizeSolucionador
FpsDisplay Sistema de diagnóstico (en perfil de configuración)
NearFade Integrado para Mixed Reality Toolkit sombreador Estándar