MRTK3 패키지 사용

Microsoft MRTK3은 Unity용 Mixed Reality Feature Tool 및 UPM(Unity 패키지 관리자)을 사용하여 Unity로 가져온 패키지 집합으로 배포됩니다. 이 패키지를 사용하면 개발자가 프로젝트 내에서 MRTK를 사용자 지정할 수 있습니다.

참고

MRTK3 프라이빗 미리 보기의 경우 Mixed Reality Feature Tool이 사용되지 않습니다. MRTK 패키지 가져오기에 대한 자세한 내용은 초기 설정을 참조하세요.

종속성

일부 MRTK3 패키지는 올바르게 작동하기 위해 Microsoft 및/또는 Unity에서 제공하는 추가 패키지가 필요합니다. 이러한 패키지 중 일부는 선택 사항이며 추가 기능을 사용하도록 설정합니다.

다음 다이어그램은 MRTK 패키지와 일부 Unity 종속성 간의 관계를 보여 줍니다.

MRTK3 Package Graph

참고

Mixed Reality Feature Tool을 통해 패키지를 가져올 때 종속성 관리가 자동으로 수행됩니다.

다음 표에서는 Mixed Reality Toolkit 패키지 종속성을 설명합니다.

표시 이름 패키지 이름 설명 필수 선택 사항
MRTK 핵심 정의 com.microsoft.mrtk.core 공유 정의, 유틸리티 및 구성 요소.
  • com.unity.xr.interaction.toolkit
  • com.unity.xr.management
MRTK 접근성 com.microsoft.mrtk.accessibility 액세스 가능한 혼합 현실 환경을 빌드하기 위한 정의, 기능 및 하위 시스템입니다.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.textmeshpro
MRTK 데이터 바인딩 및 테마 설정 com.microsoft.mrtk.data 데이터 바인딩 및 UI 요소 테마 설정 지원.
  • com.microsoft.mrtk.core
  • com.unity.nuget.newtonsoft-json
  • com.unity.textmeshpro
MRTK 진단 com.microsoft.mrtk.diagnostics 진단 및 성능 모니터링 하위 시스템 및 도구.
  • com.microsoft.mrtk.core
  • com.unity.xr.management
MRTK 환경 com.microsoft.mrtk.environment 공간 인식 및 경계와 같은 환경 기능 및 하위 시스템.
  • com.microsoft.mrtk.core
  • com.unity.xr.management
MRTK 확장 자산 com.microsoft.mrtk.extendedassets 애플리케이션에서 사용하기 위한 추가 오디오, 글꼴, 텍스처 및 기타 자산.
  • com.microsoft.mrtk.standardassets
  • com.microsoft.mrtk.graphicstools.unity
MRTK 입력 com.microsoft.mrtk.input 관절형 손, 오프라인 음성 인식 및 편집기 내 입력 시뮬레이션 지원을 포함한 입력 구성 요소.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.xr.interaction.toolkit
  • com.unity.inputsystem
  • com.unity.xr.management
  • com.unity.xr.openxr
  • com.unity.xr.arfoundation
MRTK 공간 조작 com.microsoft.mrtk.spatialmanipulation 솔버를 포함한 공간 위치 지정 및 조작 구성 요소 및 유틸리티.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.uxcore
  • com.unity.inputsystem
  • com.unity.xr.interaction.toolkit
  • com.microsoft.mrtk.input
MRTK 표준 자산 com.microsoft.mrtk.standardassets 애플리케이션에서 사용하기 위한 재료 및 질감을 포함한 표준 자산.
  • com.microsoft.mrtk.graphicstools.unity
MRTK UX 구성 요소 com.microsoft.mrtk.uxcomponents 혼합 현실을 위한 3D 사용자 인터페이스 빌드를 시작 위해 프리팹, 비주얼, 미리 만들어진 컨트롤 및 모든 것이 포함된 MRTK UX 구성 요소 라이브러리.
  • com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.standardassets
  • com.microsoft.mrtk.data
MRTK UX Core com.microsoft.mrtk.uxcore MR 사용자 인터페이스 구성 요소를 빌드하기 위한 핵심 상호 작용 및 시각화 스크립트.\n\n참고: UX 라이브러리를 빌드하는 데 사용하기 위한 것입니다. 기존 구성 요소 라이브러리로 MR 인터페이스를 빌드하려면 com.microsoft.mrtk.uxcomponents를 참조하세요.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.inputsystem
  • com.unity.textmeshpro
  • com.unity.xr.interaction.toolkit
  • com.microsoft.mrtk.data
MRTK Windows 음성 com.microsoft.mrtk.windowsspeech 네이티브 Windows 음성 API에 대한 음성 하위 시스템 구현입니다. 네이티브 Windows 음성 인식을 사용하여 이벤트를 실행하고 XRI 상호 작용을 유도할 수 있습니다.
  • com.microsoft.mrtk.core

패키지 테스트 실행

일부 MRTK 패키지에는 포함된 구성 요소의 유효성을 검사하는 데 사용되는 테스트가 포함되어 있습니다. 경우에 따라 이러한 테스트에는 종속성으로 표시되지 않은 추가 MRTK 패키지가 필요합니다.

참고

패키지를 Unity로 가져올 때 테스트 어셈블리는 기본적으로 컴파일되지 않습니다. 테스트 컴파일을 사용하도록 설정하려면 프로젝트 manifest.json 파일의 testables 요소를 사용합니다.

Mixed Reality Toolkit를 가져오는 애플리케이션에 최소한의 오버헤드를 배치하기 위해 종속성은 런타임 요구 사항에 대해서만 어설션됩니다. 다음 표에서는 포함된 테스트 어셈블리를 컴파일하고 실행하는 데 필요한 추가 패키지에 대해 설명합니다.

표시 이름 패키지 이름 요구 사항 테스트
MRTK 핵심 정의 com.microsoft.mrtk.core
MRTK 접근성 com.microsoft.mrtk.accessibility
MRTK 데이터 바인딩 및 테마 설정 com.microsoft.mrtk.data
MRTK 진단 com.microsoft.mrtk.diagnostics
MRTK 환경 com.microsoft.mrtk.environment
MRTK 확장 자산 com.microsoft.mrtk.extendedassets
MRTK 입력 com.microsoft.mrtk.input
MRTK 공간 조작 com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.mrtk.input
MRTK 표준 자산 com.microsoft.mrtk.standardassets
MRTK UX 구성 요소 com.microsoft.mrtk.uxcomponents
  • com.microsoft.mrtk.input
MRTK UX Core com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.input
MRTK Windows 음성 com.microsoft.mrtk.windowsspeech