從 HoloToolkit 升級 - MRTK2

發行項
07/04/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>`	對應至各種控制器按鈕和遊戲桿

相機

方法	HTK 2017	MRTK v2
設定	刪除MainCamera，新增MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera 預製至場景或使用混合實境工具組 > 設定 > 套用混合實境場景設定功能表項。	透過混合實境工具組 > 將 MainCamera 父代為 MixedRealityPlayspace，新增至場景並設定...
組態	在預製項目實例上執行的相機設定組態。	混合實境相機配置檔中設定的相機設定。

語音

關鍵字辨識

方法	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 Spatial Mesh Observer）新增至空間感知系統的數據提供者。
組態	在偵測器中設定場景實例。	在每個空間觀察者的配置檔上設定設定。

飛機

方法	HTK 2017	MRTK v2
設定	`SurfaceMeshesToPlanes`使用腳本。	尚未實作。

空間理解

方法	HTK 2017	MRTK v2
設定	將 SpatialUnderstanding 預製專案新增至場景。	尚未實作。
組態	在偵測器中設定場景實例。	尚未實作。

界限

方法	HTK 2017	MRTK v2
設定	將 `BoundaryManager` 腳本新增至場景。	在組態配置檔中啟用界限系統。
組態	在偵測器中設定場景實例。	在界限視覺效果配置檔中設定設定。

方法	HTK 2017	MRTK v2
設定	共用服務：將共用預製專案新增至場景。 UNet：使用 SharingWithUNET 範例。	進行中
組態	在偵測器中設定場景實例。	進行中

UX

方法	HTK 2017	MRTK v2
Button	可互動的物件	按鈕
可互動	可互動的物件	可互動
周框方塊	周框方塊	周框方塊
應用程式行	應用程式行	應用程式行
一手操作（Grb 和 Move）	HandDraggable	操作處理程式
雙手操作（抓取/移動/旋轉/縮放）	TwoHandManipulatable	操作處理程式
鍵盤	鍵盤預製專案	系統鍵盤
工具提示	Tooltip	Tooltip
物件集合	物件集合	物件集合
Solver	求解	求解

公用程式

某些公用程式已與規劃求解系統協調為重複專案。如果遺漏任何所需的腳本，請提出問題。

HTK 2017	MRTK v2
看板	`Billboard`
Tagalong	`RadialView`或`Orbital`規劃求解
FixedAngularSize	`ConstantViewSize`求解
FpsDisplay	診斷系統（在組態設定檔中）
NearFade	內建至混合實境工具組標準著色器

共用方式為