从 HoloToolkit 升级 - MRTK2

本指南帮助你从 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 IMixedRealityInputHandlerIMixedRealityInputHandler<Vector2> 映射到各种控制器按钮和控制杆

照相机

方法 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 可交互对象 Button
可交互 可交互对象 可交互
边界框 边界框 边界框
应用栏 应用栏 应用栏
单手操作(抓取和移动) HandDraggable 操作处理程序
双手操作(抓取/移动/旋转/缩放) TwoHandManipulatable 操作处理程序
键盘 键盘预制件 系统键盘
工具提示 工具提示 工具提示
对象集合 对象集合 对象集合
解算器 解算器 解算器

实用程序

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

HTK 2017 MRTK v2
标牌 Billboard
跟随 RadialViewOrbital求解器
FixedAngularSize ConstantViewSize求解器
FpsDisplay 诊断系统(在配置配置文件中)
NearFade 内置于混合现实工具包标准着色器