从 HoloToolkit 升级 - MRTK2

项目
04/18/2024

本指南帮助你从 HoloLens 工具包 (HTK) 迁移到混合现实工具包 (MRTK)。

控制器和手部输入

安装和配置

方法	HTK 2017	MRTK v2
类型	按钮的特定事件，以及输入类型信息（如果相关）。	基于操作/手势的输入，通过事件传递。
安装	将 InputManager 置于场景中。	在配置配置文件中启用输入系统，并指定具体的输入系统类型。
配置	在检查器中针对场景中的每个脚本进行配置。	通过混合现实输入系统配置文件及其下列相关配置文件进行配置。

相关配置文件：

混合现实控制器映射配置文件
混合现实控制器可视化配置文件
混合现实手势配置文件
混合现实输入操作配置文件
混合现实输入操作规则配置文件
混合现实指针配置文件

视线提供程序设置在场景中的主相机对象上进行修改。

平台支持组件（例如 Windows Mixed Reality 设备管理器）必须添加到其相应服务的数据提供程序。

接口和事件映射

某些事件不再具有唯一事件，现在包含 MixedRealityInputAction。这些操作在输入操作配置文件中指定，并映射到控制器映射配置文件中的特定控制器和平台。 OnInputDown 等事件现在应检查 MixedRealityInputAction 类型。

相关输入系统：

HTK 2017	MRTK v2	操作映射
`IControllerInputHandler`	`IMixedRealityInputHandler<Vector2>`	映射到触摸板或控制杆
`IControllerTouchpadHandler`	`IMixedRealityInputHandler`	映射到触摸板
`IFocusable`	`IMixedRealityFocusHandler`
`IGamePadHandler`	`IMixedRealitySourceStateHandler`
`IHoldHandler`	`IMixedRealityGestureHandler`	映射到手势配置文件中的按住操作
`IInputClickHandler`	`IMixedRealityPointerHandler`
`IInputHandler`	`IMixedRealityInputHandler`	映射到控制器的按钮或手部点击
`IManipulationHandler`	`IMixedRealityGestureHandler<Vector3>`	映射到手势配置文件中的操控
`INavigationHandler`	`IMixedRealityGestureHandler<Vector3>`	映射到手势配置文件中的导航
`IPointerSpecificFocusable`	`IMixedRealityFocusChangedHandler`
`ISelectHandler`	`IMixedRealityInputHandler<float>`	映射到触发器位置
`ISourcePositionHandler`	`IMixedRealityInputHandler<Vector3>` 或 `IMixedRealityInputHandler<MixedRealityPose>`	映射到指针位置或抓握位置
`ISourceRotationHandler`	`IMixedRealityInputHandler<Quaternion>` 或 `IMixedRealityInputHandler<MixedRealityPose>`	映射到指针位置或抓握位置
`ISourceStateHandler`	`IMixedRealitySourceStateHandler`
`IXboxControllerHandler`	`IMixedRealityInputHandler` 和 `IMixedRealityInputHandler<Vector2>`	映射到各种控制器按钮和控制杆

Camera

方法	HTK 2017	MRTK v2
安装	删除 MainCamera，将 MixedRealityCameraParent/MixedRealityCamera/HoloLensCamera 预制件添加到场景，或使用“混合现实工具包”>“配置”>“应用混合现实场景设置”菜单项。	通过“混合现实工具包”>“添加到场景并配置...”在 MixedRealityPlayspace 下设为父级的 MainCamera
配置	在预制件实例上执行的相机设置配置。	在混合现实相机配置文件中配置的相机设置。

语音

关键字识别

方法	HTK 2017	MRTK v2
安装	将 SpeechInputSource 添加到场景中。	必须将关键字服务（例如 Windows 语音输入管理器）添加到输入系统的数据提供程序中。
配置	在 SpeechInputSource 的检查器中配置已识别的关键字。	在混合现实语音命令配置文件中配置关键字。
事件处理程序	`ISpeechHandler`	`IMixedRealitySpeechHandler`

听写

方法	HTK 2017	MRTK v2
安装	将 DictationInputManager 添加到场景中。	听写支持要求将服务（例如 Windows 听写输入管理器）添加到输入系统的数据提供程序中。
事件处理程序	`IDictationHandler`	`IMixedRealityDictationHandlerIMixedRealitySpeechHandler`

空间感知/映射

网格

方法	HTK 2017	MRTK v2
安装	将 SpatialMapping 预制件添加到场景中。	在配置配置文件中启用空间感知系统，并将空间观察器（例如 Windows Mixed Reality 空间网格观察器）添加到空间感知系统的数据提供程序中。
配置	在检查器中配置场景实例。	在每个空间观察器的配置文件中配置设置。

平面

方法	HTK 2017	MRTK v2
安装	使用 `SurfaceMeshesToPlanes` 脚本。	尚未实现。

空间理解

方法	HTK 2017	MRTK v2
安装	将 SpatialUnderstanding 预制件添加到场景中。	尚未实现。
配置	在检查器中配置场景实例。	尚未实现。

边界

方法	HTK 2017	MRTK v2
安装	将 `BoundaryManager` 脚本添加到场景中。	在配置配置文件中启用边界系统。
配置	在检查器中配置场景实例。	在边界可视化配置文件中配置设置。

方法	HTK 2017	MRTK v2
安装	共享服务：将 Sharing 预制件添加到场景中。 UNet：使用 SharingWithUNET 示例。	正在进行
配置	在检查器中配置场景实例。	正在进行

UX

方法	HTK 2017	MRTK v2
Button	可交互对象	按钮
可交互	可交互对象	可交互对象
边界框	边界框	边界框
应用栏	应用栏	应用栏
单手操作（抓取和移动）	HandDraggable	操作处理程序
双手操作（抓取/移动/旋转/缩放）	TwoHandManipulatable	操作处理程序
键盘	键盘预制件	系统键盘
Tooltip	Tooltip	Tooltip
对象集合	对象集合	对象集合
求解器	求解器	求解器

实用程序

某些实用工具经过核对与求解系统有重复之处。如果缺少你所需的任何脚本，请提交问题。

HTK 2017	MRTK v2
标牌	`Billboard`
跟随	`RadialView`或`Orbital`规划求解器
FixedAngularSize	`ConstantViewSize`求解
FpsDisplay	诊断系统（在配置配置文件中）
NearFade	内置于混合现实工具包标准着色器中