Share via


從 HoloToolkit 升級 — MRTK2

協助您從 HoloLens 工具組 (HTK) 移轉至 Mixed Reality Toolkit (MRTK) 的指南。

控制器和手部輸入

安裝及設定

方法 HTK 2017 MRTK v2
類型 按鈕的特定事件,與相關的輸入類型資訊。 動作/手勢型輸入,透過事件傳遞。
安裝程式 將 InputManager 放在場景中。 在組 態設定檔 中啟用輸入系統,並指定具體輸入系統類型。
組態 在偵測器中,于場景中的每個個別腳本上設定。 透過Mixed Reality輸入系統設定檔及其相關設定檔進行設定,如下所示。

相關設定檔:

  • Mixed Reality控制器對應設定檔
  • Mixed Reality控制器視覺效果設定檔
  • Mixed Reality手勢設定檔
  • Mixed Reality輸入動作設定檔
  • Mixed Reality輸入動作規則設定檔
  • Mixed Reality指標設定檔

注視提供者 設定會在場景中的主要相機物件上修改。

平臺支援元件 (例如,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 預製專案新增至場景,或使用[Mixed Reality工具組 >> 設定套用Mixed Reality場景設定] 功能表項目。 透過Mixed Reality工具 > 組新增至場景並設定...,在 MixedRealityPlayspace 底下父代 MainCamera
設定 在預製專案實例上執行的相機設定組態。 Mixed Reality相機設定檔中設定的相機設定。

語音

關鍵字辨識

方法 HTK 2017 MRTK v2
安裝程式 將 SpeechInputSource 新增至您的場景。 關鍵字服務 (例如,必須將 Windows 語音輸入管理員) 新增至輸入系統的資料提供者。
設定 辨識的關鍵字是在 SpeechInputSource 的偵測器中設定。 關鍵字是在Mixed Reality語音命令設定檔中設定。
事件處理常式 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
安裝程式 將 SpatialUnderunderunder prefab 新增至場景。 尚未實作。
組態 在偵測器中設定場景實例。 尚未實作。

界限

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

共用

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

UX

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

公共事業

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

HTK 2017 MRTK v2
廣告 牌 Billboard
Tagalong RadialViewOrbital規劃求解
FixedAngularSize ConstantViewSize求解
FpsDisplay 組態設定檔中的診斷系統 ()
NearFade 內建至Mixed Reality工具組標準著色器