퀘스트에 배포 - MRTK2

메타 퀘스트(1 또는 2)가 필요합니다.

퀘스트에 대한 프로젝트 설정

1. 다음 단계에 따라 프로젝트가 Quest에 배포할 준비가 되었는지 확인합니다.
2. 디바이스에서 개발자 모드가 사용하도록 설정되어 있는지 확인합니다. Oculus ADB 드라이버 설치는 선택 사항입니다.

장면 설정

1. 새 Unity 장면을 만들거나 HandInteractionExamples와 같은 기존 장면을 엽니다.
   1. 새 장면을 만드는 경우 장면에 추가 및 구성 Mixed Reality 도구 키트로 이동하여 MRTK를 장면에> 추가합니다.

MRTK 통합

OpenXR(XR SDK)

MRTK의 Quest 디바이스 지원은 XR SDK 파이프라인용 Unity의 OpenXR 플러그 인 패키지와 Mixed Reality OpenXR 플러그 인 패키지의 두 가지 소스를 통해 제공됩니다. OpenXR XRSDK 데이터 공급자를 사용하면 두 원본을 모두 사용할 수 있으며 퀘스트에 MRTK를 배포하는 데 사용해야 합니다.

Mixed Reality OpenXR 플러그 인을 사용하여 MRTK 애플리케이션을 Quest에 배포할 수 있습니다. OpenXR을 사용하도록 설정한 후 필요한 기능이 활성화되어 있는지 확인합니다("손 추적" 및 "메타 퀘스트 지원").

프로필(MRTK 기본값을 사용하지 않는 경우)이 OpenXR 디바이스 관리자 설정되어 있는지 확인합니다. 프로필이 OpenXR에 대해 준비되었는지 확인하는 방법에 대한 자세한 내용은 XR SDK 파이프라인에 대한 MRTK 구성 을 참조하세요.

Oculus(XR SDK)

MRTK의 Quest 디바이스 지원은 XR SDK 파이프라인용 Unity의 Oculus 플러그 인 패키지와 Oculus Integration Unity 패키지의 두 가지 소스를 통해 제공됩니다. Oculus XRSDK 데이터 공급자를 사용하면 두 원본을 모두 사용할 수 있으며 Oculus Quest에 MRTK를 배포하는 데 사용해야 합니다.

Unity XR SDK 파이프라인을 사용하면 퀘스트를 통해 Oculus Touch 컨트롤러 및 헤드 추적을 사용할 수 있습니다. 이 파이프라인은 Unity 2019.3 이상에서 XR 애플리케이션을 개발하기 위한 표준입니다. 이 파이프라인을 사용하려면 Unity 2019.3 이상을 사용하고 있는지 확인합니다. 이는 QUEST에 MRTK 애플리케이션을 배포하는 데 필요합니다 .

Oculus Integration Unity 패키지를 사용하면 Quest에서 손 추적 및 컨트롤러 모델을 사용할 수 있습니다.

퀘스트용 XR SDK 파이프라인 설정

1. Oculus XR 플러그 인이 창 --> 패키지 관리자 아래에 설치되어 있는지 확인합니다.

   

2. 편집 -- 프로젝트 설정 -- XR 플러그 인 관리> -->> 플러그 인 공급자로 이동하여 Oculus 플러그 인 공급자가 프로젝트에 포함되어 있는지 확인합니다.

   

손 추적을 사용하도록 Oculus Integration Unity 패키지 설정

1. Unity 자산 저장소에서 Oculus Integration 을 다운로드하고 가져옵니다. 작동하도록 테스트된 최신 버전은 39.0.0입니다. 이전 버전은 Oculus API 변경으로 인해 작동하지 않습니다. 모든 버전의 Oculus 통합 패키지는 이 보관 파일에서 찾을 수 있습니다.

2. Mixed Reality 도구 키트 > 유틸리티 > Oculus > 통합 Oculus Integration Unity 모듈로 이동합니다. 이렇게 하면 관련 퀘스트 코드가 작동하는 데 필요한 정의 및 참조로 asmdefs가 업데이트됩니다. 또한 csc 파일을 업데이트하여 Oculus 통합 자산에서 생성된 오래된 경고를 필터링합니다. MRTK 리포지토리에는 경고를 오류로 변환하는 csc 파일이 포함되어 있으며, 이 변환은 MRTK-Quest 구성 프로세스를 중지합니다.

   

3. 가져온 Oculus 폴더(Assets/Oculus에서 찾을 수 있음)에는 OculusProjectConfig라는 스크립트 가능한 개체가 있습니다. 해당 구성 파일에서 HandTrackingSupport를 "컨트롤러 및 손"으로 설정해야 합니다.

   

Oculus XR SDK 데이터 공급자 사용

1. Oculus XR SDK 데이터 공급자를 사용하도록 프로필 구성
   • 구성 프로필을 수정하지 않으려는 경우
     • Unity의 XR 파이프라인에서 모두 구성된 기본 MRTK 프로필을 사용합니다. 이전 DefaultXRSDKConfigurationProfile의 레이블은 이제 사용되지 않습니다.
     • 빌드로 이동하여 퀘스트에 프로젝트를 배포합니다.
   • 그렇지 않으면 다음을 따릅니다.

     • 계층 구조에서 MixedRealityToolkit 게임 개체를 선택하고 복사 및 사용자 지정을 선택하여 기본 혼합 현실 프로필을 복제합니다.

       

     • 입력 구성 프로필을 선택합니다.

       

     • 입력 시스템 프로필에서 복제 를 선택하여 수정을 사용하도록 설정합니다.

       

     • 입력 데이터 공급자 섹션을 열고 맨 위에서 데이터 공급자 추가를 선택하면 목록 끝에 새 데이터 공급자가 추가됩니다. 새 데이터 공급자를 열고 형식을 Microsoft.MixedReality.Toolkit.XRSDK.Oculus OculusXRSDKDeviceManager>로 설정합니다.

       

1. Oculus XR SDK 데이터 공급자에는 입력을 올바르게 라우팅하도록 OVR 카메라 리그 및 OVR 핸즈로 프로젝트를 자동으로 구성하는 OVR 카메라 리그 프리팹이 포함되어 있습니다. 장면에 OVR 카메라 리그를 수동으로 추가하려면 설정 및 입력을 수동으로 구성해야 합니다.

프로젝트에서 Oculus 통합 제거

1. Mixed Reality Toolkit > Oculus > Separate Oculus Integration Unity Modules 이동합니다.
2. Microsoft.MixedReality.Toolkit.Providers.Oculus.asmdef 및 기타 파일의 참조로 Unity 새로 고침을 이 단계에서 수정합니다.
3. Unity 닫기
4. 열려 있는 경우 Visual Studio 닫기
5. 파일 탐색기 열고 MRTK Unity 프로젝트의 루트로 이동합니다.
6. UnityProjectName/Library 디렉터리 삭제
7. UnityProjectName/Assets/Oculus 디렉터리 삭제
8. UnityProjectName/Assets/Oculus.meta 파일 삭제
9. Unity 다시 열기

퀘스트에 프로젝트 빌드 및 배포

1. USB 3.0 -> USB C 케이블을 통해 퀘스트 연결

2. 파일 > 빌드 설정으로 이동합니다.

3. 배포를 Android로 변경

4. 퀘스트가 해당 실행 장치로 선택되었는지 확인합니다.

   

5. 빌드 및 실행 선택

   • 빌드 및 실행을 처음 선택하면 다음과 같은 빌드 오류 집합이 발생할 수 있습니다. 배포를 방지해서는 안 됩니다. 자세한 내용 및 잠재적 완화 옵션은 문제 #10449 를 참조하세요.

   

6. 퀘스트 내에서 USB 디버깅 허용 프롬프트 수락

7. 퀘스트 내에서 장면 보기

일반 오류

Unity에서 인식할 수 없는 퀘스트

Android 경로가 제대로 구성되어 있는지 확인합니다. 문제가 계속 발생하면 이 가이드를 따르세요.

기본 설정 > 편집 > 외부 도구 > Android에서 확인합니다.