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:

• Información general sobre acciones del usuario
• Eventos de entrada
• Punteros de entrada

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