HoloToolkit에서 업그레이드 - MRTK2

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

컨트롤러 및 손 입력

설치 및 구성

메서드 HTK 2017 MRTK v2
Type 관련된 경우 입력 형식 정보가 포함된 단추에 대한 특정 이벤트입니다. 이벤트를 통해 전달되는 동작/제스처 기반 입력입니다.
설치 프로그램 장면에 InputManager를 배치합니다. 구성 프로필에서 입력 시스템을 사용하도록 설정하고 구체적인 입력 시스템 형식을 지정합니다.
구성 장면의 각 개별 스크립트에 대해 검사기에서 구성됩니다. 아래에 나열된 Mixed Reality 입력 시스템 프로필 및 관련 프로필을 통해 구성됩니다.

관련 프로필:

  • Mixed Reality 컨트롤러 매핑 프로필
  • Mixed Reality 컨트롤러 시각화 프로필
  • Mixed Reality 제스처 프로필
  • Mixed Reality 입력 작업 프로필
  • Mixed Reality 입력 작업 규칙 프로필
  • Mixed Reality 포인터 프로필

응시 공급자 설정은 장면의 Main 카메라 개체에서 수정됩니다.

플랫폼 지원 구성 요소(예: 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 Toolkit > Mixed Reality 장면 설정 메뉴 항목 적용을 구성 > 합니다. MainCamera는 Mixed Reality Toolkit > 장면에 추가 및 구성을 통해 MixedRealityPlayspace에서 부모로 설정됩니다.
구성 프리팹 인스턴스에서 수행되는 설정 구성을 카메라. Mixed Reality 카메라 프로필에 구성된 카메라 설정입니다.

음성

키워드 인식

메서드 HTK 2017 MRTK v2
설치 프로그램 장면에 SpeechInputSource를 추가합니다. 키워드 서비스(예: Windows Speech Input Manager)를 입력 시스템의 데이터 공급자에 추가해야 합니다.
구성 인식된 키워드는 SpeechInputSource의 검사기에서 구성됩니다. 키워드는 Mixed Reality Speech Commands Profile에서 구성됩니다.
이벤트 처리기 ISpeechHandler IMixedRealitySpeechHandler

받아쓰기

메서드 HTK 2017 MRTK v2
설치 프로그램 장면에 DictationInputManager를 추가합니다. 받아쓰기 지원을 사용하려면 입력 시스템의 데이터 공급자에 서비스(예: Windows 받아쓰기 입력 관리자)를 추가해야 합니다.
이벤트 처리기 IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

공간 인식/매핑

메시

메서드 HTK 2017 MRTK v2
설치 프로그램 장면에 SpatialMapping 프리팹을 추가합니다. 구성 프로필에서 공간 인식 시스템을 사용하도록 설정하고 공간 인식 시스템의 데이터 공급자에 공간 관찰자(예: 공간 Mesh 관찰자 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
단추 상호 작용 가능한 개체 Button
상호 작용 가능 상호 작용 가능한 개체 상호 작용 가능
경계 상자 경계 상자 경계 상자
앱 바 앱 바 앱 바
한 손 조작(Grb 및 이동) HandDraggable 조작 처리기
두 손 조작(잡기/이동/회전/배율) TwoHandManipulatable 조작 처리기
Keyboard 키보드 프리팹 시스템 키보드
도구 설명 도구 설명 도구 설명
개체 컬렉션 개체 컬렉션 개체 컬렉션
Solver Solver Solver

유틸리티

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

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