HoloToolkit에서 업그레이드 - MRTK2

아티클
07/12/2023

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

컨트롤러 및 손 입력

설정 및 구성

메서드	HTK 2017	MRTK v2
형식	관련된 경우 입력 형식 정보가 포함된 단추에 대한 특정 이벤트입니다.	이벤트를 통해 전달되는 동작/제스처 기반 입력입니다.
설치 프로그램	장면에 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 도구 키트 > 구성 > Mixed Reality 장면 설정 적용 메뉴 항목을 사용합니다.	MainCamera는 Mixed Reality 도구 키트 장면에 추가 및 구성...을 > 통해 MixedRealityPlayspace에서 부모로 설정됩니다.
구성	프리팹 instance 카메라 설정 구성이 수행됩니다.	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 공간 메시 관찰자)를 추가합니다.
구성	검사기에서 장면 instance 구성합니다.	각 공간 관찰자의 프로필에 대한 설정을 구성합니다.

비행기

메서드	HTK 2017	MRTK v2
설치 프로그램	스크립트를 `SurfaceMeshesToPlanes` 사용합니다.	아직 구현되지 않았습니다.

공간 이해

메서드	HTK 2017	MRTK v2
설치 프로그램	장면에 SpatialUnderstanding 프리팹을 추가합니다.	아직 구현되지 않았습니다.
구성	검사기에서 장면 instance 구성합니다.	아직 구현되지 않았습니다.

경계

메서드	HTK 2017	MRTK v2
설치 프로그램	장면에 `BoundaryManager` 스크립트를 추가합니다.	구성 프로필에서 경계 시스템을 사용하도록 설정합니다.
구성	검사기에서 장면 instance 구성합니다.	경계 시각화 프로필에서 설정을 구성합니다.

메서드	HTK 2017	MRTK v2
설치 프로그램	공유 서비스: 장면에 공유 프리팹을 추가합니다. UNet: SharingWithUNET 예제를 사용합니다.	진행 중
구성	검사기에서 장면 인스턴스를 구성합니다.	진행 중

UX

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

유틸리티

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

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