从 HoloToolkit 升级

一个指南,可帮助你从 HoloLens Toolkit (HTK) MRTK Toolkit (混合现实) 。

控制器和手动输入

设置和配置

方法 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 预制件添加到场景或使用混合现实 Toolkit > 配置 > 应用混合现实场景 设置 菜单项。 MainCamera 在 MixedRealityPlayspace 下通过混合现实Toolkit >添加到场景并配置...
配置 在预制实例上执行的相机设置配置。 在配置文件 中配置的 混合现实相机设置

语音

关键字识别

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

听写

方法 HTK 2017 MRTK v2
设置 将听写InputManager 添加到场景中。 听写支持需要 (,例如Windows听写输入管理器) 添加到输入系统的数据提供程序。
事件处理程序 IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

空间感知/映射

网格

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

飞机

方法 HTK 2017 MRTK v2
设置 使用 SurfaceMeshesToPlanes 脚本。 尚未实现。

空间理解

方法 HTK 2017 MRTK v2
设置 将 SpatialUnderstanding prefab 添加到场景中。 尚未实现。
配置 在检查器中配置场景实例。 尚未实现。

边界

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

共享

方法 HTK 2017 MRTK v2
设置 共享服务:将共享 prefab 添加到场景中。 UNet:使用 SharingWithUNET 示例。 正在进行
配置 在检查器中配置场景实例。 正在进行

UX

方法 HTK 2017 MRTK v2
Button 种不可交互对象 Button
可交互 种不可交互对象 可交互
边界框 边界框 边界框
应用栏 应用栏 应用栏
一次操作 (Grb 并移动) HandDraggable 操作处理程序
两次操作 (获取/移动/旋转/缩放) TwoHandManipulatable 操作处理程序
Keyboard 键盘 prefab 系统键盘
工具提示 工具提示 工具提示
对象集合 对象集合 对象集合
解算器 解算器 解算器

实用工具

某些实用工具已与规划求解系统的副本一致。 如果缺少所需的任何脚本,请解决问题。

HTK 2017 MRTK v2
宣传 Billboard
Tagalong RadialViewOrbital 规划求解
FixedAngularSize ConstantViewSize规划求解
FpsDisplay 配置文件中的诊断系统 ()
NearFade 内置到混合现实 Toolkit 标准着色器