HoloToolkit에서 업그레이드 - MRTK2

아티클
07/04/2024

HoloLens Toolkit(HTK)에서 MRTK(Mixed Reality Toolkit)로 마이그레이션하는 데 도움이 되는 가이드입니다.

컨트롤러 및 손 입력

설정 및 구성

메서드	HTK 2017	MRTK v2
Type	관련된 경우 입력 형식 정보가 포함된 단추에 대한 특정 이벤트입니다.	이벤트를 통해 전달되는 동작/제스처 기반 입력입니다.
설정	장면에 InputManager를 배치합니다.	구성 프로필에서 입력 시스템을 사용하도록 설정하고 구체적인 입력 시스템 유형을 지정합니다.
구성	장면의 각 개별 스크립트에 대해 검사기에서 구성됩니다.	아래에 나열된 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 프리팹을 장면 에 추가하거나 Mixed Reality Toolkit > Configure > Apply Mixed Reality Scene Settings 메뉴 항목을 사용합니다.	Mixed Reality Toolkit > 장면에 추가 및 구성을 통해 MixedRealityPlayspace에서 부모로 지정된 MainCamera...
구성	프리팹 인스턴스에서 수행되는 카메라 설정 구성입니다.	Mixed Reality 카메라 프로필에 구성된 카메라 설정입니다.

음성

키워드 인식

메서드	HTK 2017	MRTK v2
설정	장면에 SpeechInputSource를 추가합니다.	키워드 서비스(예: Windows Speech Input Manager)를 입력 시스템의 데이터 공급자에 추가해야 합니다.
구성	인식된 키워드는 SpeechInputSource의 검사기에서 구성됩니다.	키워드는 Mixed Reality Speech 명령 프로필에 구성됩니다.
이벤트 처리기	`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
설정	공유 서비스: 장면에 공유 프리팹을 추가합니다. UNet: SharingWithUNET 예제를 사용합니다.	진행 중
구성	검사기에서 장면 인스턴스를 구성합니다.	진행 중

UX

메서드	HTK 2017	MRTK v2
단추	상호 작용 가능한 개체	버튼
상호 작용 가능	상호 작용 가능한 개체	상호 작용 가능
경계 상자	경계 상자	경계 상자
앱 바	앱 바	앱 바
한 손 조작(Grb 및 이동)	HandDraggable	조작 처리기
두 손 조작(잡기/이동/회전/배율)	TwoHandManipulatable	조작 처리기
Keyboard	키보드 프리팹	시스템 키보드
Tooltip	도구 설명	도구 팁
개체 컬렉션	개체 컬렉션	개체 컬렉션
해 찾기	해 찾기	해 찾기

유틸리티

일부 유틸리티는 해 찾기 시스템과 중복으로 조정되었습니다. 필요한 스크립트가 누락된 경우 문제를 제출하세요.

HTK 2017	MRTK v2
Billboard	`Billboard`
Tagalong	`RadialView` 또는 `Orbital` 해 찾기
FixedAngularSize	`ConstantViewSize`솔 버
FpsDisplay	진단 시스템 (구성 프로필)
NearFade	Mixed Reality Toolkit 표준 셰이더에 기본 제공

다음을 통해 공유