MRTK 패키지 - MRTK2

아티클
2025. 02. 18.

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

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

자산 패키지

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

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

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

몇 가지 과제는 다음과 같습니다.

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

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

Foundation
확장
도구
테스트 유틸리티
예

이러한 패키지는 GitHub의 소스 코드에서 Microsoft에서 릴리스 및 지원됩니다.

Foundation 패키지

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

^{MRTK Foundation 패키지}

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

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

확장 패키지

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

참고

확장 패키지에는 Microsoft.MixedRealityToolkit가 필요합니다. Unity. 토대.

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

도구 패키지

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

참고

도구 패키지에는 Microsoft.MixedRealityToolkit가 필요합니다. Unity. 토대.

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

테스트 유틸리티 패키지

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

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

예제 패키지

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

HandInteractionExample 장면

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

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

참고

예제 패키지에는 Microsoft.MixedRealityToolkit가 필요합니다. Unity. 토대.

폴더	구성 요소	설명
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 도구 키트의 기초를 형성합니다.

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

종속성:

Standard 자산(com.microsoft.mixedreality.toolkit.standardassets)

Standard 자산

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

MRTK Standard 셰이더
MRTK Standard 셰이더를 사용하는 기본 재질
오디오 파일
글꼴
텍스처
아이콘

참고

어셈블리 정의에 따라 호환성이 손상되는 변경을 방지하기 위해 MRTK Standard 셰이더의 일부 기능을 제어하는 데 사용되는 스크립트는 표준 자산 패키지에 포함되지 않습니다. 이러한 스크립트는 폴더의 기본 패키지에서 MRTK/Core/Utilities/StandardShader 찾을 수 있습니다.

종속성: 없음

확장 패키지

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

폴더	구성 요소	설명
MRTK/확장
	HandPhysicsService	굴절식 손에 물리학 지원을 추가하는 서비스입니다.
	LostTrackingService	Microsoft HoloLens 디바이스에서 추적 손실 전달을 간소화하는 서비스입니다.
	SceneTransitionService	부드러운 장면 전환을 추가하는 것을 간소화하는 서비스입니다.
	샘플~	샘플 장면 및 자산이 포함된 숨겨진(Unity 편집기) 폴더입니다.

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

종속성:

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

도구 패키지

선택적 도구 패키지(com.microsoft.mixedreality.toolkit.tools) 에는 혼합 현실 환경을 만드는 데 유용한 도구가 포함되어 있습니다. 일반적으로 이러한 도구는 편집기 구성 요소이며 해당 코드는 애플리케이션의 일부로 제공되지 않습니다.

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

종속성:

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

테스트 유틸리티 패키지

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

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

종속성:

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

예제 패키지

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

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

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

종속성:

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

참고 항목

추가 리소스

설명서

MRTK2-Unity 개발자 설명서 - MRTK 2

Mixed Reality Toolkit for Unity 대해 알아봅니다.
예제 장면 - MRTK 2

MRTK의 예제 장면을 획득하고 사용하는 방법을 알아봅니다.
Mixed Reality Feature Tool 시작 - Mixed Reality

HoloLens 및 VR 개발용 MR Feature Tool의 기본 사항에 대해 알아봅니다.
MRTK2 예제 허브 사용해 보기 - MRTK 2

HoloLens 디바이스에서 Mixed Reality Toolkit 예제 허브 애플리케이션을 로드하고 사용하는 방법을 알아봅니다.
Unity 패키지 관리자 사용 - MRTK 2

Unity 패키지 관리자에서 MRTK 사용
HoloLens용 Unity 개발 - Mixed Reality

큐레이트된 검사점 경험을 통해 Unity 및 HoloLens에서 혼합 현실 앱 빌드를 시작합니다.
HoloLens 및 WMR 헤드셋에 배포 - MRTK 2

다양한 디바이스에 앱을 빌드하고 배포하기 위한 설명서입니다.

학습

모듈

Mixed Reality Toolkit를 사용하여 Unity에서 혼합 현실 프로젝트 설정 - Training

MRTK(Mixed Reality Toolkit)를 Unity 프로젝트로 가져와서 혼합 현실을 더욱 빠르게 개발하세요. 프로젝트를 HoloLens에 배포할 수도 있습니다.

여러분의 미래

다음을 통해 공유

MRTK 패키지 - MRTK2

자산 패키지

Foundation 패키지

확장 패키지

도구 패키지

테스트 유틸리티 패키지

예제 패키지

Unity 패키지 관리자

Foundation 패키지

Standard 자산

확장 패키지

도구 패키지

테스트 유틸리티 패키지

예제 패키지

참고 항목

추가 리소스