Microsoft Mixed Reality Toolkit 2.7 릴리스 정보

  • 아티클

2.7.3의 새로운 기능

Redmond에게 특히 감사드립니다.

MRTK 팀은 MRTK 커뮤니티 덕분에 웜을 확장하려고 합니다. 여러분의 기여, 피드백 및 투표는 MRTK가 2021 Auggie Award for Best Developer Tool을 수상하는 데 도움이 되었습니다! 여러분의 지원이 없으면 오늘날의 우리는 없었을 것입니다. 새 플랫폼 지원, 새 기능, 버그 수정, 제안, 질문 또는 기여했을 수 있는 다른 다양한 방법을 추가할 수 있습니다. 감사합니다!

2021 Auggie Awards Best Developer Tool

Unity 2021 지원

2.7.3 릴리스를 통해 Unity 2021에서 더 쉽게 빌드할 수 있습니다. Unity 2021에서 MRTK를 사용하는 동안 문제가 발견되면 GitHub 리포지토리에 문제를 제출하세요.

Remoting 지원을 통한 장면 이해(OpenXR만 해당)

이제 OpenXR 플랫폼이 포함된 HoloLens 2에서 원격 설치 중에 장면 이해를 사용할 수 있습니다.

MRTK 2.7.3 버그 수정 및 변경 내용

  • 프로필이 해당 폴더에 복제되지 않는 한 CustomProfiles 폴더 생성을 중지했습니다(#9916).
  • GameObjects에서 .gameObject에 대한 호출을 제거했습니다(#9939).
  • 구성 요소가 비활성화된 개체로 인해 포인터에서 포커스가 잠길 수 있는 버그가 수정되었습니다(#9945).
  • Unity 2021에 대해 사용되지 않은 메서드 및 수정된 컴파일러 오류가 업데이트되었습니다(#9938).
  • Unity 2021에 대한 link.xml가 수정되었습니다(#9942).
  • 아이콘 이름을 표시하도록 단추 구성 검사기를 업데이트했습니다(#9972).
  • 컨트롤러 매핑 목록의 헤더 및 정렬이 업데이트되었습니다(#9976).
  • MRTK에 대한 다양한 Unity가 개선되었습니다(#9940).
  • BoundsControl 충돌체 문제 및 불일치를 수정했습니다(#9973).
  • 단추 아이콘 집합 검사기를 수정했습니다(#9999).
  • BoundsControl 스케일링 핸들 충돌체 정렬을 수정했습니다(#10007).
  • 분류하는 SDF 글꼴 텍스처를 수정했습니다(#10006).
  • BoundsControl 자동 평면화 및 스케일링 핸들 방향을 수정했습니다(#10013).
  • BoundsControl 평면화 수정에 대한 피드백이 추가되었습니다(#10016).
  • 애니메이션 재생 중 손 메시가 있는 이상한 변형을 수정했습니다(#10024).
  • 장면 이해를 위한 로깅 및 SpatialAwarenessSurfaceTypes를 수정했습니다(#10026).
  • Leap 예제 장면 스크립트에 독립 실행형 정의 지시문을 추가했습니다(#10036).
  • 편집기에서 기본이 아닌 활성화 유형을 지정할 때 BoundsControlOnEnable 문제를 수정했습니다(#10039).
  • OpenGL ES 및 Metal에 대한 잘못된 셰이더 바이트 코드 오류를 수정했습니다(#10041).
  • Unity 2020에서 빌드 창 고정을 수정하기 위한 ClearProgressBar 호출을 추가했습니다(#10046).
  • 글꼴 자산에 대한 serialization을 업데이트했습니다(#10047).
  • 적절한 핀치 슬라이더 충돌체를 갖도록 손 조작 장면을 수정했습니다(#10060).
  • 표면 자성 쿼터니언 수학을 수정했습니다(#10074).
  • 향상된 PV 카메라 버전 메시지를 개선했습니다(#10077).
  • BoundingBoxHelper.GetRawBoundsCorners 보호 수준을 수정했습니다(#10093).
  • gLTF 가져오기 로그를 여러 로그가 아닌 하나의 로그로 업데이트되었습니다(#10090)
  • MRTK가 없는 장면에서 MRSceneContent 스크립트를 제거했습니다(#10091).
  • Unity 2018 호환성을 위한 예제 장면에서 패키지 기반 이벤트 시스템을 제거했습니다(#10092).
  • Microsoft OpenXR 패키지 미리 보기에 대한 지원을 제거했습니다(#10119).
  • 데이터를 받을 때 앱이 중지되는 문제를 수정했습니다(#10033).
  • 충돌기에서 EyeTrackingTarget와 충돌없이 충돌기로 전달할 때 EyeTrackingTarget가 OnLookAway를 트리거하지 않는 문제를 수정했습니다(#10127).
  • 마우스 포인터 동작을 보다 직관적으로 만들기 위해 기본 포인터 익스텐트를 변경했습니다(#10075).
  • 초기화가 실행되는 시기를 명확하게 하기 위해 요약이 업데이트되었습니다(#10177).
  • LinePointer에서 NullReferenceException 문제를 수정했습니다(#10190).
  • 균일하지 않은 크기 조정 문제가 있는 BoundsControl을 수정했습니다(#10133).
  • 다른 문화권에서 IOSMinOSVersion의 처리를 수정했습니다(#10178).
  • 시선 응시 사용 개체에서 추가 광선 캐스트를 제거했습니다(#10162).
  • MixedRealityToolkit 프리팹에 대한 편집기 검사기에서 다양한 프로필을 마우스로 가리킬 때 도구 설명이 추가되었습니다(#10180).
  • EyeTrackingExample의 음성 명령 드롭다운 및 업데이트 명령을 수정했습니다(#10197).
  • Unity의 표준 셰이더 로드할 때 검은색으로 표시되는 'gLTF' 개체가 수정되었습니다(#10209).
  • IsEnabled 속성이 false인 경우 UnityTouchDeviceManager 업데이트 자체를 수정했습니다(#10203).
  • 단추 구성 도우미에서 속성 이름을 업데이트했습니다(#10221).
  • 개체 내보내기에서 좌표 공간, 권선 순서 및 문화권 서식을 수정했습니다(#10208).
  • 그립 포인트를 손끝으로 이동하는 옵션이 추가되었습니다(#10206).
  • Leap UnityModules 4.9.1 지원이 추가되었습니다(#10282).
  • ReserializeAssetsUtility.cs에 대한 몇 가지 사소한 변경 내용이 백포칭되었습니다(#10280).
  • enumValueIndex의 잘못된 사용을 intValue로 변환했습니다(#10274).
  • 근 조작 중에 드리프트하는 개체를 수정했습니다(#10294).
  • 경계 컨트롤이 다른 구성 요소를 적극적으로 제거하는 경우를 수정했습니다(#10296).
  • 깜박이는 근접 조명을 수정했습니다(#10325).
  • 해당 이벤트를 실행하기로 결정하기 전에 이벤트에 연결된 것이 있는지 확인하는 검사를 추가했습니다(#10330).
  • 사소한 사항의 분류를 변경했습니다(#10316).
  • HasFlag에 대한 대안이 도입되었습니다(#10319).
  • HandConstraint 해결기 디버그 로그 스팸 줄이기(#10331)
  • HandConstraintPalmUp.cs에서 오는 로그 스팸을 수정했습니다(#10326).
  • OpenXR을 통한 홀로그램 원격화를 위한 장면 이해를 사용하도록 설정했습니다(#10338).
  • InteractableOnClickReceiver에 매개 변수가 없는 생성자가 추가되었습니다(#10353).
  • FingerChaser 프리팹을 예제 패키지의 Common 폴더로 이동했습니다(#10358).
  • OpenXR에서 굴절된 손 선택에 대한 대체 사례가 추가되었습니다(#10359).
  • Windows Mic Stream 데모 UPM 가져오기 문제를 해결했습니다(#10362).
  • OpenXR 프로필의 이름이 변경했습니다(#10363).
  • Unity 2021에서 Raycast 적중 로그 출력이 향상되고 AssetBundles를 사용할 때 충돌이 해결되었습니다(#10370).
  • 할당을 줄이기 위해 문자열을 const 및 캐시 형식으로 업데이트했습니다(#10369).
  • 앱 기반 Holographic Remoting을 사용할 때 XRSDK 기반 메시 관찰자를 수정했습니다(#10366).
  • Oculus 시각화를 통합했습니다(#10067).
  • BoundsControl 속성에 대한 설명서가 추가되었습니다(#10361).
  • 손 관절 체이서 프리팹을 수정했습니다(#10377).
  • Oculus Quest에 대한 배포 오류를 수정했습니다(10374).
  • 장면 이해 예제 장면 프로필 관련 문제를 해결했습니다(#10368).
  • 최신 버전의 Unity 2021.2에서 가져올 때 MRTK 콘솔 오류를 해결했습니다(#10182).
  • 커서를 변경하는 방법에 대한 누락된 설명서가 추가되었습니다(#4934).
  • MRTK Unity 패키지 릴리스 페이지의 지침이 더 명확하도록 개선되었습니다(#9575).
  • MicStream 선택 데모 장면에서 음성(UPM 패키지)을 처리하지 않는 문제가 해결되었습니다(#9908).
  • MRTK 예제 패키지에서 샘플을 개별적으로 가져올 수 없는 문제가 해결되었습니다(#10216).
  • 일부 속성에 대한 BoundsControl 누락 설명서가 추가되었습니다(#10346).
  • InteractableOnClickReceiver를 상호 작용 가능한 구성 요소가 있는 게임 개체에 추가할 수 없는 버그를 수정했습니다(#10341).

2\.7.2의 새로운 기능

UPM 패키지 종속성 문제 수정

종속성이 올바르게 설정되지 않은 MRTK 2.7.1 UPM 패키지에 문제가 있습니다. 이 문제로 인해 Mixed Reality Feature Tool이 MRTK 2.7.1 패키지를 제대로 가져오지 못했습니다. 이 문제는 이제 2.7.2에서 해결되었습니다. 이 버전에서는 2.7.1에 비해 코드 변경이 없습니다.

2\.7.1의 새로운 기능

버전 표시

이제 Mixed Reality > Toolkit 메뉴에는 프로젝트에서 사용 중인 MRTK 버전을 확인하기 위해 Mixed Reality Toolkit Foundation 패키지를 검사하는 버전 표시... 항목이 포함됩니다.

버전 메뉴 표시

MRTK 버전 대화 상자

참고

MRTK가 GitHub 리포지토리에서 복제된 경우 버전 정보가 설정되지 않습니다.

버전을 확인할 수 없음

작성자 목록

MRTK 2.7.1부터 작성자 목록 파일이 Mixed Reality Toolkit Foundation 패키지에 포함됩니다.

OpenXR 프로젝트 설정을 Configurator 설정 흐름에 통합

MRTK 2.7.1부터는 Mixed Reality OpenXR 플러그 인 사용자에게 MRTK로 플러그 인을 설정하는 방법에 대한 지침이 제공됩니다. HoloLens 2를 대상으로 하는 사용자가 권장 설정을 자동으로 적용할 수 있는 옵션이 있습니다.

OpenXR 설치 지침이 포함된 Configurator 창

주목할 만한 버그 수정 및 변경 내용

  • XR SDK 파이프라인에서 Unity Joystick Manager가 지원됨으로 표시 #9954, #9994
  • null 오류를 방지하기 위해 상호 작용 가능한 검사기 코드에 검사를 추가 #9943
  • 펄스 셰이더 예제 장면에 OpenXR 메시 공급자 추가 #9902
  • 손 물리학 프로필을 예제 장면으로 복원 #9915
  • HandConstraint 스크립트에 대한 일부 정리 #9935
  • 프로필 만들기 및 복제에 영향을 주는 일부 버그 수정 #9982

2\.7.0의 새로운 기능

OpenXR이 이제 MRTK에서 공식적으로 지원됩니다.

새로운 OpenXR 플러그 인이 점점 더 발전하면서 MRTK가 이제 공식적으로 OpenXR을 지원합니다. 이전 릴리스와 비교하여 OpenXR을 사용하여 프로젝트에 다음과 같은 기능을 추가했습니다.

OpenXR을 통해 HoloLens 2 또는 Windows Mixed Reality 헤드셋을 대상으로 하는 경우 Mixed Reality Feature Tool을 통해 Mixed Reality OpenXR 플러그 인 버전 0.9.5 이상을 설치/업데이트해야 합니다. 그렇지 않으면 위의 개선 사항 중 일부가 누락될 수 있습니다.

Legacy XR 및 XR SDK 데이터 공급자는 이제 동일한 프로필 내에서 사용할 수 있습니다.

데이터 공급자는 이제 적절한 파이프라인을 선택한 경우에만 로드되므로 Legacy XR 및 XR SDK 데이터 공급자가 동일한 프로필 내에서 공존할 수 있습니다. 이를 수용하기 위해 이제 프로필 보기 내 여러 탭 아래에 Legacy XR 및 XR SDK 데이터 공급자가 구성되어 있습니다. 이 구성은 대상 XR 파이프라인에 대해 올바른 프로필을 선택했는지 여부를 확인하는 데 도움이 됩니다.

이제 Legacy 및 XR SDK 데이터 공급자를 단일 프로필로 통합할 수 있습니다.

이를 수용하기 위해 이제 null 데이터 공급자가 더 이상 로드되지 않고 프로필 검사기에 표시되지 않습니다. 사용자는 편집 -> 프로젝트 설정 -> Mixed Reality Toolkit에서 Show null data providers in the profile inspector를 전환하여 누락된 데이터 공급자가 있는 예기치 않은 동작을 디버깅할 수 있습니다.

Null 데이터 공급자는 이제 기본적으로 숨겨져 있습니다.프로필 검사기에서 null 데이터 공급자 표시 설정/해제

환경 설정 및 관련 Mixed Reality Scene Content 동작 추가

이제 사용자는 환경 설정을 구성하여 MRTK가 대상 환경에 따라 Mixed Reality Scene Content를 적절하게 표시할 수 있습니다.

사용자의 이전 환경 스케일링 설정이 새 환경 설정 프로필과 일치하지 않으면 검사기에서 수정하라는 메시지가 표시됩니다.

환경 스케일링 마이그레이션

새로 디자인된 Configurator는 이제 설정 프로세스를 통해 사용자를 안내합니다.

새로운 MRTK Configurator는 XR 개발 및 MRTK와 함께 사용하기 위해 프로젝트를 적절하게 구성하기 위한 단계별 지침을 사용자에게 제공합니다. 여기에는 XR 파이프라인 선택, 플랫폼별 플러그 인 가져오기, TextMeshPro 가져오기, 예제(UPM 사용 시) 및 기타 이전에 포함된 프로젝트 권장 설정이 포함됩니다.

파이프라인 목록을 표시하는 Configurator

등급이 지정된 텔레포트 핫스팟

새 텔레포트 핫스팟 구성 요소는 등급이 지정되었습니다. GameObject에 텔레포트 핫스팟을 추가하여 사용자가 해당 위치로 텔레포트할 때 특정 위치와 방향에 있도록 할 수 있습니다.

텔레포트 핫스팟 예

등급이 지정된 유지

유지 기능과 예는 이제 실험 등급이 지정되었습니다. 볼륨 HoloLens 2 스타일 단추의 새로운 예가 샘플 장면에 포함되어 있습니다.

유지 영웅

Leap Motion Unity Module 버전 4.6.0, 4.7.0, 4.7.1 및 4.8.0에 대한 지원 추가

최신 버전의 Leap Motion Unity 모듈에 대한 지원이 이제 MRTK 2.7.0과 호환됩니다. 자세한 내용은 Leap Motion에 대한 MRTK 구성 방법을 참조하세요.

새로운 LeapMotionOrientationExample 장면에 기여해 주신 @jackyangzzh 님에게 감사드립니다!

대상 지정 음성 이벤트가 발생하면 더 이상 응시 포인터로 제한되지 않음

이전에는 대상 지정 음성 이벤트는 응시 포인터를 사용하여 포커스가 있는 개체에서만 발생할 수 있었습니다. 이제 개체가 포인터에 의해 포커스가 맞춰지면 음성 이벤트를 받을 수 있습니다.

원거리 포인터를 사용한 음성 이벤트

HTK에서 MRTK로 TextToSpeech 포팅

이제 SpeechSynthesizer를 사용하여 UWP 플랫폼의 텍스트에서 음성을 생성할 수 있도록 MRTK에서 인기 있는 TextToSpeech 스크립트를 사용할 수 있습니다. 또한 기능을 보여주기 위해 샘플 장면을 추가했습니다.

OpenXR에서 시스템 제공 모션 컨트롤러 모델 지원

OpenXR에서 시스템 제공 모션 컨트롤러 모델에 대해 편집기 내 및 런타임 시 지원이 추가되었습니다.

두 모션 컨트롤러 모델이 표시된 편집기 창

OpenXR에서 HoloLens 2 관절형 손 메시 지원

MRTK 예제 장면에서 디바이스 내에서 실행되는 손 메시

레거시 WMR, Windows XR 플러그 인 및 OpenXR에서 컨트롤러 햅틱 지원

레거시 WMR, Windows XR 플러그 인 및 OpenXR에서 컨트롤러 햅틱 지원이 추가되었습니다. #9735

Windows XR 플러그 인에서 시선 추적 지원

Windows XR 플러그 인 최소 버전 2.7.0(Unity 2019), 4.4.2(Unity 2020) 및 5.2.2(Unity 2021)를 사용할 때 시선 응시에 대한 지원이 추가되었습니다. #9609

주목할 만한 버그 수정 및 변경 내용

  • 손가락 모으기 감지가 더 부드러워졌습니다. 이제 실수로 손가락 모으기 제스처가 드롭되는 현상이 줄어들었습니다. #9576
  • 개체 조작자 구성 요소가 있는 오브젝트는 이제 플래그가 설정될 때 속도를 일관되게 유지합니다. #9733
  • 이제 Back-strafing이 바닥을 확인하여 카메라가 환경에 삽입될 수 있는 상황이나 사용자가 빈 공간 위에 떠 있는 상황을 방지합니다. #9697
  • IsNearObject는 이제 가상 속성이 되어 스피어 또는 포크 포인터를 확장할 때 더욱 유연해졌습니다. #9803
  • 단추는 이제 사용 가능한 음성 명령을 나타낼 때 적절한 키워드를 표시합니다. #9824
  • Oculus 컨트롤러는 이제 자체 독립형 비주얼라이저를 사용하여 MRTK 시각화가 Oculus 통합 패키지의 시각화와 충돌하지 않도록 합니다. #9589
  • 키보드 관련 스크립트가 최신 Unity 버전(2019.4.25+ 및 2020.3.2+)의 동작에 맞게 변경되었습니다. 릴리스 당시에도 HoloLens에 영향을 미치는 자동 완성 버그와 TMP 입력 필드 버그(둘 다 MRTK 외부에 있음)가 있습니다. 자세한 내용은 #9056 및 #9724를 참조하세요.
  • 스크롤 개체 컬렉션의 성능이 향상되었습니다. 또한 컬렉션 내의 GameObject가 중복될 때 재질이 손실되는 문제도 해결되었습니다. #9813, #9718
  • 장면 이해 데모 스크립트에서 특정 종류의 관찰된 모든 장면 개체를 검색하도록 GetSceneObjectsOfType 기능을 추가했습니다. #9524, #9744
  • 명령줄 빌드 도구에서는 sceneList 또는 sceneListFile 플래그(플래그가 있는 경우)로 지정된 장면만 빌드에 포함됩니다. #9695
  • 빌드 도구에는 msbuild(기본 옵션)를 사용하는 대신 nuget.exe에 대한 경로를 지정하고 이 경로를 사용하여 패키지 복원을 수행하는 새 옵션이 있습니다. #9556
  • Windows XR 플러그 인을 사용하면 손 관절이 부실해지고 손 메시가 이중으로 발생하는 문제가 해결되었습니다. #9890
  • Windows XR 플러그 인의 자동 원격 기능을 사용하여 입력 및 상호 작용이 누락되는 문제가 해결되었습니다. #9868
  • BuildDeployWindow가 Windows SDK 경로에 대해 잘못된 reg 키를 쿼리하는 문제가 해결되었습니다. #9664
  • MRTK의 glTF 가져오기 도구는 이제 선택 사항입니다. glTF 가져오기 도구가 여러 개 있는 경우 사용자 지정 스크립팅 정의 기호에 MRTK_GLTF_IMPORTER_OFF를 추가하여 MRTK를 사용하지 않도록 설정할 수 있습니다. #9658
  • OpenVR의 Knuckles 컨트롤러가 제대로 감지되지 않는 문제가 해결되었습니다. #9881
  • 손 메시를 시각화할 때 프레임당 할당 수를 줄입니다. #9756
  • MRTK 예제 패키지(Unity 패키지 관리자에서)를 실행하는 메뉴 항목을 추가하여 샘플을 더 쉽게 가져올 수 있습니다. #9798
  • Unity 2020.3을 사용할 때 로드 시간 경고 수가 줄어들었습니다.
  • 빌드 창 기능 문서 추가: 페이지 방문

알려진 문제

오디오 데모에 asmdef 파일(UPM 패키지)이 없습니다.

Mixed Reality Feature Tool을 통해 MRTK를 가져올 때 Unity 패키지 관리자 UI를 사용하여 샘플과 데모가 프로젝트에 추가됩니다. 오디오 데모를 가져온 후에는 WindowsMicrophoneStreamDemo.unity 장면이 제대로 작동하지 않습니다. 이 동작은 샘플에 대한 asmdef 파일이 누락된 결과입니다.

이 문제를 해결하려면 다음 단계를 수행합니다.

  • Library/PackageCache/com.microsoft.mixedreality.toolkit.examples@[...]/MRTK.Examples.asmdef를 "Assets/Samples/Mixed Reality Toolkit Examples" 폴더에 복사합니다.
  • 복사한 파일의 이름을 Examples로 바꿉니다.
  • Examples 파일을 엽니다.
  • 이름 상자에서 내용을 Examples로 대체합니다.
  • 적용을 클릭합니다.
  • 빌드 및 배포

이 문제는 향후 MRTK 릴리스에서 해결될 예정입니다.

MRTK 빌드 창이 Unity 2020.3에서 무기한 "자산 가져오기" 대화 상자를 트리거합니다.

Unity 2020.3의 MRTK 빌드 창에는 UWP 빌드 후 "자산 가져오기" 대화 상자가 완료되지 않는 알려진 문제가 있습니다. 이 문제는 Unity와 함께 조사 중입니다.

Unity 2020의 Text Mesh Pro 캔버스 렌더러 경고

Unity 2020을 사용하는 동안 대부분의 MRTK 예제 장면에 다음 경고가 기록됩니다.

Please remove the `CanvasRenderer` component from the [TextMeshPro] GameObject as this component is no longer necessary.

캔버스 렌더러 경고가 TextMeshPro 버전 3.0.3에 추가되었습니다. 이러한 경고는 MRTK의 예제 장면에 영향을 미치지 않으며 콘솔에서 지울 수 있습니다. 자세한 내용은 문제 9811을 참조하세요.