HoloToolkit에서 업그레이드

HoloLens Toolkit (HTK)에서 Mixed Reality Toolkit (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 IMixedRealityInputHandlerIMixedRealityInputHandler<Vector2> 다양 한 컨트롤러 단추 및 thumbsticks에 매핑됨

카메라

메서드 HTK 2017 MRTK v2
설치 프로그램 maincamera를 삭제 하거나, MixedRealityCameraParent/MixedRealityCamera/HoloLensCamera prefab를 장면에 추가 하거나, 혼합 현실 설정 메뉴 항목을 사용 하 여 혼합 > 현실 장면 적용 Toolkit 구성 합니다. Mixed Toolkit Reality를 통해 MixedRealityPlayspace 아래에 있는 maincamera는 > 장면에 추가 하 고 구성 하는 중 ...
구성 Prefab 인스턴스에서 수행 하는 카메라 설정 구성입니다. 혼합 현실 카메라 프로필에 구성 된 카메라 설정

Speech

키워드 인식

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

받아쓰기

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

공간 인식/매핑

메시

메서드 HTK 2017 MRTK v2
설치 프로그램 장면에 SpatialMapping prefab를 추가 합니다. 구성 프로필에서 공간 인식 시스템을 사용 하도록 설정 하 고 공간 인식 시스템의 데이터 공급자에 공간 관찰자 (예: Windows Mixed Reality 공간 메시 관찰자)를 추가 합니다.
구성 검사기에서 장면 인스턴스를 구성 합니다. 각 공간 관찰자 프로필에 대 한 설정을 구성 합니다.

평면

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

공간 이해

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

경계

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

공유

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

UX

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

유틸리티

일부 유틸리티는 해 찾기 시스템에서 중복으로 조정 되었습니다. 필요한 스크립트가 없는 경우 문제를 파일에 입력 하십시오.

HTK 2017 MRTK v2
빌보드 Billboard
Tagalong RadialView또는 OrbitalRadialView
FixedAngularSize ConstantViewSizeConstantViewSize
FpsDisplay 진단 시스템 (구성 프로필)
NearFade 혼합 현실 Toolkit 표준 셰이더에 기본 제공