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 relevante.	Entrada basada en gestos o acción, que se pasa a través de eventos.
Configurar	Coloque 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 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 mirada se modifica en el objeto Cámara principal de la escena.

Los componentes de compatibilidad de la plataforma (por ejemplo, Windows Mixed Reality Administrador de dispositivos) deben agregarse a los proveedores de datos de su servicio correspondiente.

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:

• 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 analógico
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 o pulsaciones de mano del controlador
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 de controlador y sticks analógicos

Cámara

Métodos	HTK 2017	MRTK versión 2
Configurar	Elimine MainCamera, agregue mixedRealityCameraParent / MixedRealityCamera / HoloLensCamera prefab a la escena o use Mixed Reality Toolkit > Configure Apply Mixed Reality Scene Settings (Configurar > Mixed Reality configuración de escena).	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 y asignación espaciales

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 observador de malla espacial) 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	Button
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
Teclado	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
Billboard	Billboard
Tagalong	RadialView o OrbitalSolver
FixedAngularSize	ConstantViewSizeSolver
FpsDisplay	Sistema de diagnóstico (en perfil de configuración)
NearFade	Sombreador estándar integrado para Mixed Reality Toolkit