MRTK 패키지

MRTK(Mixed Reality Toolkit)는 Mixed Reality 하드웨어 및 플랫폼에 대한 지원을 제공하여 플랫폼 간 Mixed Reality 애플리케이션 개발을 가능하게 하는 패키지의 컬렉션입니다.

MRTK는 자산(.unitypackage) 패키지 및 Unity 패키지 관리자통해 사용할 수 있습니다.

자산 패키지

MRTK 자산(.unitypackage)은 GitHub다운로드할 수 있습니다.

자산 패키지를 사용할 경우의 이점 중 일부는 다음과 같습니다.

  • Unity 2018.4 이상에서 사용 가능
  • MRTK를 쉽게 변경
    • MRTK는 Assets 폴더에 있습니다.

다음은 몇 가지 문제입니다.

  • MRTK는 프로젝트의 Assets 폴더에 속하여
    • 대규모 프로젝트
    • 느린 컴파일 시간
  • 종속성 관리 없음
    • 고객은 패키지 의존도를 수동으로 해결해야 합니다.
  • 수동 업데이트 프로세스
    • 여러 단계
    • 대용량(3000개 이상의 파일) 소스 제어 업데이트
    • MRTK 변경 내용 손실 위험
  • 예제 패키지를 가져오는 것은 일반적으로 모든 예제를 포함하는 것을 의미합니다.

사용 가능한 패키지는 다음과 같습니다.

이러한 패키지는 microsoft에서 GitHub mrtk_release 분기의 소스 코드에서 릴리스되고 지원됩니다.

Foundation 패키지

Mixed Reality Toolkit Foundation은 애플리케이션이 Mixed Reality Platforms에서 공통 기능을 활용할 수 있도록 하는 코드 집합입니다.

Pakage FoundationMRTK Foundation 패키지

MRTK Foundation 패키지에는 다음이 포함됩니다.

폴더 구성 요소 Description
MRTK/Core 인터페이스 및 형식 정의, 기본 클래스, 표준 셰이더.
MRTK/Core/Providers 플랫폼에 구애받지 않은 데이터 공급자
손을 손 추적을 위한 기본 클래스 지원 및 서비스입니다.
InputAnimation 머리 이동 및 손 추적 데이터 기록을 지원합니다.
InputSimulation 손 및 눈 입력의 편집기 내 시뮬레이션을 지원합니다.
ObjectMeshObserver 3D 모델을 데이터로 사용하는 공간 인식 관찰자입니다.
UnityInput 일반적인 입력 디바이스(원통형, 마우스 등) Unity의 입력 API를 통해 구현됩니다.
MRTK/공급자 플랫폼별 데이터 공급자
LeapMotion UltraLeap Leap Motion 컨트롤러에 대한 지원.
OpenVR OpenVR 디바이스에 대한 지원.
Oculus Quest와 같은 Oculus 디바이스를 지원합니다.
UnityAR (실험적) 모바일 AR 디바이스에서 MRTK를 사용할 수 있도록 하는 카메라 설정 공급자입니다.
WindowsMixedReality Microsoft HoloLens 및 몰입형 헤드셋을 포함하여 Windows Mixed Reality 디바이스에 대한 지원
Windows Microsoft Windows 특정 API(예: 음성 및 받아쓰기)에 대한 지원
XR SDK (실험적) Unity 2019.3 이상에서 Unity의 새 XR 프레임워크를 지원합니다.
MRTK/SDK
실험적 셰이더, 사용자 인터페이스 컨트롤 및 개별 시스템 관리자를 비롯한 실험적 기능
기능 Foundation 패키지를 기반으로 하는 기능입니다.
Profiles Microsoft Mixed Reality Toolkit 시스템 및 서비스에 대한 기본 프로필입니다.
StandardAssets 일반 자산; 모델, 질감, 재질 등
MRTK/SceneSystemResources 장면 시스템에서 사용하는 자산 및 리소스
MRTK/서비스
BoundarySystem VR 경계 지원을 구현하는 시스템입니다.
CameraSystem 카메라 구성 및 관리를 구현하는 시스템입니다.
DiagnosticsSystem 애플리케이션 진단에서 구현하는 시스템(예: 시각적 프로파일러)
InputSystem 사용자 입력 액세스 및 처리에 대한 지원을 제공하는 시스템입니다.
SceneSystem 다중 장면 애플리케이션 지원을 제공하는 시스템입니다.
SpatialAwarenessSystem 사용자 환경을 인식하기 위한 지원을 제공하는 시스템입니다.
TeleportSystem 원격 보고(점프 환경 이동)에 대한 지원을 제공하는 시스템입니다.
MRTK/StandardAssets 혼합 현실 환경을 위한 MRTK 표준 셰이더, 기본 재질 및 기타 표준 자산

확장 패키지

선택적 Microsoft.MixedRealityToolkit.Unity.Extensions 패키지에는 Microsoft Mixed Reality Toolkit 기능을 확장하는 추가 서비스가 포함되어 있습니다.

참고

확장 패키지에는 Microsoft.MixedRealityToolkit.Unity.Foundation이 필요합니다.

폴더 구성 요소 Description
MRTK/확장
HandPhysicsService 굴절형 손에서 물리학 지원을 추가하는 서비스입니다.
LostTrackingService Microsoft HoloLens 디바이스에서 손실 추적 처리를 간소화하는 서비스입니다.
SceneTransitionService 부드러운 장면 전환을 추가하는 것을 간소화하는 서비스입니다.

도구 패키지

선택적 Microsoft.MixedRealityToolkit.Unity.Tools 패키지에는 Microsoft Mixed Reality Toolkit 사용하여 혼합 현실 개발 환경을 개선하는 유용한 도구가 포함되어 있습니다. 이러한 도구는 Unity 편집기에서 Mixed Reality Toolkit 유틸리티 메뉴에 있습니다.

참고

도구 패키지에는 Microsoft.MixedRealityToolkit.Unity.Foundation이 필요합니다.

폴더 구성 요소 Description
MRTK/도구
BuildWindow UWP 애플리케이션을 빌드하고 배포하는 프로세스를 간소화하는 데 도움이 되는 도구입니다.
DependencyWindow 프로젝트에서 자산의 종속성 그래프를 만드는 도구입니다.
ExtensionServiceCreator 확장 서비스 만들기를 지원하는 마법사입니다.
MigrationWindow 사용되지 않는 MRTK 구성 요소를 사용하는 코드를 업데이트하는 데 도움이 되는 도구입니다.
OptimizeWindow Unity에서 최상의 성능을 위해 혼합 현실 프로젝트 구성을 자동화하는 데 도움이 되는 유틸리티입니다.
ReserializeAssetsUtility 특정 Unity 파일의 재시작을 지원합니다.
RuntimeTools/Tools/ControllerMappingTool 유틸리티를 사용하면 개발자가 하드웨어 컨트롤러에 대한 Unity 매핑을 신속하게 확인할 수 있습니다.
ScreenshotUtility Unity 편집기에서 애플리케이션 이미지를 캡처할 수 있습니다.
TextureCombinerWindow 그래픽 질감을 결합하는 유틸리티입니다.
도구 상자 MRTK UX 구성 요소를 쉽게 검색하고 사용할 수 있는 UI입니다.

테스트 유틸리티 패키지

선택적 Microsoft.MixedRealityToolkit.TestUtilities 패키지는 개발자가 재생 모드 테스트를 쉽게 만들수 있도록 하는 도우미 스크립트의 컬렉션입니다. 이러한 유틸리티는 MRTK 구성 요소를 만드는 개발자에게 특히 유용합니다.

폴더 구성 요소 Description
MRTK/테스트
TestUtilities 손 시뮬레이션 유틸리티를 포함하여 재생 모드 테스트 만들기를 간소화하는 방법입니다.

예제 패키지

예제 패키지에는 기본 패키지에서 기능을 연습하는 데모, 샘플 스크립트 및 샘플 장면이 포함되어 있습니다. 이 패키지에는 다양한 유형의 손 입력에 응답하는 샘플 개체(굴절형 및 비열음)가 포함된 HandInteractionExample 장면(아래 그림 참조)이 포함되어 있습니다.

HandInteractionExample 장면

이 패키지에는 여기에 설명된 시선 추적 데모도 포함되어 있습니다.

일반적으로 MRTK의 모든 새 기능에는 예제 패키지에 해당하는 예제가 포함되어야 하며 대략 동일한 폴더 구조와 위치를 따라야 합니다.

참고

예제 패키지에는 Microsoft.MixedRealityToolkit.Unity.Foundation이 필요합니다.

폴더 구성 요소 Description
MRTK/예제
데모 하나 또는 두 개의 관련 기능을 보여주는 간단한 장면입니다.
실험적 실험적 기능을 보여주는 데모 장면입니다.
StandardAssets 여러 데모 장면에서 공유하는 공통 자산입니다.

Unity 패키지 관리자

Unity 2019.4 이상에서 만드는 환경의 경우 Unity 패키지 관리자통해 MRTK를 사용할 수 있습니다.

자산 패키지를 사용할 경우의 이점 중 일부는 다음과 같습니다.

  • 더 작은 프로젝트
    • 더 클리너 Visual Studio 솔루션
    • 체크 인할 파일 수가 더 적습니다(MRTK는 파일의 간단한 참조). Packages/manifest.json
  • 더 빠른 컴파일
    • Unity는 빌드하는 동안 MRTK를 다시 컴파일할 필요가 없습니다.
  • 종속성 확인
    • 필수 MRTK 패키지는 필수 항목이 있는 패키지를 지정할 때 자동으로 설치됩니다.
  • 새 MRTK 버전에 대한 간편한 업데이트
    • 파일의 버전 변경 Packages/manifest.json

다음은 몇 가지 문제입니다.

  • MRTK는 불변성입니다.
    • 패키지를 확인하는 동안 제거할 수 없으면 변경할 수 없습니다.
  • MRTK는 Unity 2018.4에서 UPM 패키지를 지원하지 않습니다.

Foundation 패키지

기본 패키지( com.microsoft.mixedreality.toolkit.foundation )는 Mixed Reality Toolkit 기초를 형성합니다.

폴더 구성 요소 Description
MRTK/Core 인터페이스 및 형식 정의, 기본 클래스, 표준 셰이더.
MRTK/Core/Providers 플랫폼에 구애받지 않은 데이터 공급자
손을 손 추적을 위한 기본 클래스 지원 및 서비스입니다.
InputAnimation 머리 이동 및 손 추적 데이터 기록을 지원합니다.
InputSimulation 손 및 눈 입력의 편집기 내 시뮬레이션을 지원합니다.
ObjectMeshObserver 3D 모델을 데이터로 사용하는 공간 인식 관찰자입니다.
UnityInput 일반적인 입력 장치 (조이스틱, 마우스 등) Unity의 입력 API를 통해 구현 됩니다.
MRTK/공급자 플랫폼별 데이터 공급자
LeapMotion UltraLeap Leap 동작 컨트롤러에 대 한 지원.
OpenVR OpenVR 장치 지원.
Oculus Quest와 같은 Oculus 장치 지원.
UnityAR 시험용 모바일 AR 장치에서 MRTK를 사용 하도록 설정 하는 카메라 설정 공급자입니다.
WindowsMixedReality Microsoft HoloLens 및 모던 헤드셋을 비롯 한 Windows Mixed Reality 장치 지원.
Windows Microsoft Windows 특정 api (예: 음성 및 받아쓰기)를 지원 합니다.
XR SDK 시험용 Unity 2019.3 이상에서 unity의 NEW XR framework 를 지원 합니다.
MRTK/SDK
실험적 셰이더, 사용자 인터페이스 컨트롤 및 개별 시스템 관리자를 비롯 한 실험적 기능
기능 기본 패키지를 기반으로 하는 기능입니다.
Profiles Microsoft Mixed Reality의 기본 프로필 Toolkit 시스템 및 서비스입니다.
StandardAssets 일반적인 자산 모델, 질감, 재질 등
MRTK/서비스
BoundarySystem VR 경계 지원을 구현 하는 시스템입니다.
CameraSystem 카메라 구성 및 관리를 구현 하는 시스템입니다.
DiagnosticsSystem 응용 프로그램 진단에서 시스템을 구현 합니다 (예: 시각적 프로파일러).
InputSystem 사용자 입력에 대 한 액세스 및 처리 지원을 제공 하는 시스템입니다.
SceneSystem 다중 장면 응용 프로그램 지원을 제공 하는 시스템입니다.
SpatialAwarenessSystem 사용자 환경을 인식 하기 위한 지원을 제공 하는 시스템입니다.
TeleportSystem Teleporting에 대 한 지원을 제공 하는 시스템 (점프의 경험에 대 한 이동).

종속성:

  • 표준 자산 ( com.microsoft.mixedreality.toolkit.standardassets )

표준 자산

표준 자산 패키지 ( com.microsoft.mixedreality.toolkit.standardassets) 은 다음을 비롯 한 모든 혼합 현실 환경에 권장 되는 구성 요소 모음입니다.

  • MRTK 표준 셰이더
  • MRTK 표준 셰이더를 사용 하는 기본 자료
  • 오디오 파일
  • 글꼴
  • 텍스처
  • 아이콘

참고

어셈블리 정의를 기반으로 하는 주요 변경 내용을 방지 하기 위해 MRTK 표준 셰이더의 일부 기능을 제어 하는 데 사용 되는 스크립트는 표준 자산 패키지에 포함 되지 않습니다. 이러한 스크립트는 폴더의 foundation 패키지에서 찾을 수 있습니다 MRTK/Core/Utilities/StandardShader .

종속성: 없음

확장 패키지

선택적 확장 패키지 ( com.microsoft.mixedreality.toolkit.extensions) MRTK의 기능을 확장 하는 추가 구성 요소 포함)

폴더 구성 요소 Description
MRTK/Extensions
HandPhysicsService 트레일러 지원을 추가 하는 서비스입니다.
LostTrackingService Microsoft HoloLens 장치에서 추적 손실의 처리를 간소화 하는 서비스입니다.
SceneTransitionService 부드러운 장면 전환 추가를 간소화 하는 서비스입니다.
샘플 ~ 샘플 장면 및 자산을 포함 하는 숨겨진 (Unity 편집기) 폴더입니다.

예제 프로젝트를 포함 하는 패키지를 사용 하는 프로세스에 대 한 자세한 내용은 Mixed Reality Toolkit 및 Unity 패키지 관리자 문서에서 찾을 수 있습니다.

종속성:

  • Foundation ( com.microsoft.mixedreality.toolkit.foundation )

도구 패키지

선택적 도구 패키지 ( com.microsoft.mixedreality.toolkit.tools) 혼합 현실 환경 만들기에 유용한 도구 포함) 일반적으로 이러한 도구는 편집기 구성 요소 이며 해당 코드는 응용 프로그램의 일부로 제공 되지 않습니다.

폴더 구성 요소 Description
MRTK/Tools
BuildWindow UWP 응용 프로그램 빌드 및 배포 프로세스를 간소화 하는 데 도움이 되는 도구입니다.
DependencyWindow 프로젝트의 자산에 대 한 종속성 그래프를 만드는 도구입니다.
ExtensionServiceCreator 확장 서비스를 만드는 데 도움이 되는 마법사입니다.
MigrationWindow 사용 되지 않는 MRTK 구성 요소를 사용 하는 코드 업데이트에 도움이 되는 도구입니다.
OptimizeWindow Unity에서 최상의 성능을 위해 혼합 현실 프로젝트를 자동으로 구성 하는 데 도움이 되는 유틸리티입니다.
ReserializeAssetsUtility 특정 Unity 파일을 다시 serialize 하기 위한 지원을 제공 합니다.
RuntimeTools/Tools/ControllerMappingTool 개발자가 하드웨어 컨트롤러에 대 한 Unity 매핑을 신속 하 게 결정할 수 있도록 하는 유틸리티입니다.
ScreenshotUtility Unity 편집기에서 응용 프로그램 이미지를 캡처할 수 있습니다.
TextureCombinerWindow 그래픽 질감을 결합 하는 유틸리티입니다.
도구 상자 MRTK UX 구성 요소를 쉽게 검색 하 고 사용할 수 있도록 하는 UI입니다.

종속성:

  • Foundation( com.microsoft.mixedreality.toolkit.foundation )

테스트 유틸리티 패키지

선택적 테스트 유틸리티 com.microsoft.mixedreality.toolkit.testutilities 패키지()에는 개발자가 재생 모드 테스트를 쉽게 만들 수 있는 도우미 스크립트 컬렉션이 포함되어 있습니다. 이러한 유틸리티는 MRTK 구성 요소를 만드는 개발자에게 특히 유용합니다.

폴더 구성 요소 Description
MRTK/테스트
TestUtilities 손 시뮬레이션 유틸리티를 포함하여 재생 모드 테스트 만들기를 간소화하는 방법입니다.

종속성:

  • Foundation( com.microsoft.mixedreality.toolkit.foundation )

예제 패키지

예제 패키지( com.microsoft.mixedreality.toolkit.examples )는 개발자가 관심 있는 예제만 가져올 수 있도록 구조화되어 있습니다.

예제 프로젝트가 포함된 패키지를 사용하는 프로세스에 대한 자세한 내용은 Mixed Reality Toolkit 및 Unity 패키지 관리자 문서에서 찾을 수 있습니다.

폴더 구성 요소 Description
MRTK/예제
샘플~ 샘플 장면 및 자산이 포함된 숨겨진(Unity 편집기) 폴더입니다.
StandardAssets 여러 데모 장면에서 공유하는 공통 자산입니다.

종속성:

  • Foundation( com.microsoft.mixedreality.toolkit.foundation )
  • 확장 기능(com.microsoft.mixedreality.toolkit.extensions)

참고 항목