MRTK 없이 새 OpenXR 프로젝트 설정
Microsoft와 커뮤니티는 혼합 현실에 대한 환경을 자동으로 설정하는 MRTK(Mixed Reality Toolkit)와 같은 오픈 소스 도구를 만들었지만, 일부 개발자는 처음부터 환경을 빌드하고자 할 수 있습니다.
고려해야 할 기타 비 OpenXR 구성 옵션
Windows XR: Microsoft는 Unity 2020의 새 프로젝트에 Windows XR 플러그 인을 사용하지 않는 것이 좋습니다. 대신 Mixed Reality OpenXR 플러그 인을 사용해야 합니다. 그러나 Unity 2019를 사용 중이고 ARCore/ARKit 디바이스와의 호환성을 위해 AR Foundation 2.0이 필요한 경우 이 플러그 인을 통해 해당 지원을 사용할 수 있습니다.
중요
Unity 2019에서 이 플러그 인을 사용하는 것은 Azure Spatial Anchors와 호환되지 않습니다.
레거시 XR:
Unity 2019 이하 버전에 있는 경우 레거시 기본 제공 XR 지원을 사용하는 것이 좋습니다. Windows XR 플러그 인은 Unity 2019에서 작동하지만 Unity 2019의 Azure Spatial Anchors와 호환되지 않으므로 권장하지 않습니다.
새 프로젝트를 시작하는 경우 대신 Unity 2020을 설치하고 Mixed Reality OpenXR 플러그 인을 사용하는 것이 좋습니다.
OpenXR 시작: 새 Unity 프로젝트 만들기
유니티 허브 시작합니다.
프로젝트 탭에서 새 프로젝트 클릭합니다.
새 프로젝트 아래의 드롭다운을 클릭한 다음 원하는 편집기 버전을 선택합니다.
선택한 템플릿이 3D Core인지 확인합니다.
프로젝트 이름 상자에 프로젝트의 이름(예: “MRTK 자습서”)을 입력합니다.
위치 상자에서 폴더 아이콘을 클릭한 다음 프로젝트를 저장할 폴더로 이동하여 선택합니다. 필요에 따라 새 폴더를 만들 수도 있습니다.
프로젝트 만들기를 클릭합니다. 그러면 Unity에서 프로젝트가 열립니다.
주의
Windows에서 작업하는 경우 255자의 MAX_PATH 제한이 있습니다. Unity는 이러한 제한의 영향을 받으며, 파일 경로가 255자를 초과하는 경우 컴파일이 실패할 수 있습니다. 따라서 드라이브 루트와 최대한 가까운 위치에 Unity 프로젝트를 저장하는 것이 좋습니다.
빌드 대상 설정
메뉴 모음에서 File(파일)>Build Settings(빌드 설정)... 를 차례로 선택합니다.
Windows Mixed Reality 위한 앱을 빌드하려면 빌드 대상을 선택해야 합니다. UWP(유니버설 Windows 플랫폼)에 대한 빌드 설정은 HP Reverb G2와 같은 몰입형 헤드셋을 포함한 모든 디바이스를 대상으로 합니다. 이 방법은 HoloLens 2 위해 빌드하는 경우에 가장 적합합니다. 그러나 데스크톱 VR을 대상으로 하는 경우 PC, Mac & Linux 독립 실행형 플랫폼을 사용하는 것이 좋습니다.
다음 중 하나를 수행합니다.
데스크톱 VR을 대상으로 하는 경우:
- 새 Unity 프로젝트에서 기본적으로 선택된 PC, Mac & Linux 독립 실행형 플랫폼을 유지합니다.
HoloLens 2 대상으로 지정하는 경우:
- 플랫폼에서유니버설 Windows 플랫폼 선택합니다. 다음 설정이 활성 상태인지 확인합니다.
빌드 형식: D3D Project
대상 SDK 버전: 최신 설치됨
최소 플랫폼 버전: 10.0.10240.0
Visual Studio 버전: 최신 설치됨
플랫폼 전환 단추를 클릭합니다. Unity는 플랫폼을 전환하는 동안 진행률 표시줄을 표시합니다.
플랫폼 전환 프로세스가 완료되면 빌드 설정 창을 닫습니다.
Mixed Reality 기능 도구 다운로드 및 설치
Mixed Reality OpenXR 플러그 인은 Unity용 패키지 형식으로 제공됩니다. 기능 패키지를 검색, 업데이트 및 가져오는 가장 좋은 방법은 Mixed Reality 기능 도구를 사용하는 것입니다. 가져오기 전에 이름 또는 카테고리로 패키지를 검색하고, 종속성을 확인하고, 프로젝트 매니페스트 파일에 대한 제안된 변경 내용을 볼 수 있습니다.
다운로드가 완료되면 실행 파일 MixedRealityFeatureTool.exe 이동한 다음, 이를 사용하여 Mixed Reality 기능 도구를 시작합니다.
Mixed Reality OpenXR 플러그 인 가져오기
Mixed Reality Feature Tool에서 시작을 선택합니다.
찾아보기 단추(아래 이미지의 "3점" 단추)를 선택한 다음 Unity 프로젝트가 포함된 폴더로 이동한 다음 엽니다.
참고
Tool의 프로젝트 경로 상자에는 값이 포함되어야 하므로 기본적으로 백슬래시("_")가 삽입됩니다.
폴더를 선택한 후 Tool은 올바른 Unity 프로젝트 폴더인지 확인합니다.
기능 검색을 선택합니다.
참고: Tool이 피드에서 패키지를 새로 고치는 동안 몇 초 정도 기다려야 할 수 있습니다.
기능 검색 페이지에 6개의 패키지 그룹 목록이 있습니다.
플랫폼 지원(0/5) 왼쪽에 있는 “+” 단추를 클릭한 다음 최신 버전의 Mixed Reality OpenXR 플러그 인을 선택합니다.
선택한 후 기능 가져오기를 클릭합니다.
유효성 검사를 선택하여 선택한 패키지의 유효성을 검사합니다. 유효성 검사 문제가 발견되지 않았습니다라는 대화 상자가 표시됩니다. 표시되면 확인을 클릭합니다.
기능 가져오기 페이지에서 왼쪽의 기능 열에 방금 선택한 패키지가 표시됩니다. 오른쪽의 필수 종속성 열에 종속성이 표시됩니다. 이러한 항목의 세부 정보 링크를 클릭하여 해당 항목에 대해 자세히 알아볼 수 있습니다.
계속 진행할 준비가 되면 가져오기를 선택합니다. 검토 및 승인 페이지에서 패키지에 대한 정보를 검토할 수 있습니다.
승인을 선택합니다.
Unity 편집기로 돌아와 UI의 빈 영역을 클릭합니다. 패키지를 가져오고 있음을 보여 주는 진행률 표시줄이 표시됩니다.
입력 백 엔드 설정 구성
Unity에서 패키지를 가져온 후 편집기를 다시 시작하여 백 엔드를 사용하도록 설정할지 묻는 경고가 나타납니다. 예를 선택합니다.
프로젝트 유효성 검사를 통해 HoloLens 2 프로젝트 구성(MR OpenXR 1.6 이상)
데스크톱 VR용으로 개발하는 경우 이 섹션을 건너뛰고 데스크톱 VR에 대한 프로젝트 구성으로 이동합니다.
- 메뉴 모음에서 Mixed Reality > 프로젝트 유효성 검사 설정 > HoloLens 2 애플리케이션(UWP)을 클릭하여 HoloLens 2 대한 유효성 검사 규칙을 사용하도록 설정합니다. 버전 1.9 이전의 MR OpenXR 플러그 인의 경우 사용 가능한 메뉴 항목은 HoloLens 2 > 프로젝트 > 적용 권장 프로젝트 설정을 Mixed Reality.
- 팝업되는 프로젝트 유효성 검사 창에서 UWP 플랫폼 탭(Windows 로고로 표시됨)에 있는지 확인하고 모두 수정을 클릭하여 유효성 검사 문제를 resolve. 모두 수정을 클릭한 후에도 문제가 남아 있을 수 있습니다. 이 경우 모두 수정 을 다시 클릭하고 "장면별"(있는 경우)으로 표시된 문제를 무시하고 나머지 문제(있는 경우)를 통해 제안된 변경 내용이 있는지 확인합니다.
- 이 시점에서 프로젝트는 HoloLens 2 배포할 준비가 거의 완료되었습니다. 다음 단계를 위해 플레이어 설정 구성 을 진행합니다.
수동으로 HoloLens 2 대한 프로젝트 구성
데스크톱 VR용으로 개발하는 경우 이 섹션을 건너뛰고 데스크톱 VR용 프로젝트 구성으로 이동합니다.
프로젝트 설정 창이 열려 있는지 확인합니다. 그렇지 않은 경우 메뉴 모음에서프로젝트 설정편집>을 선택합니다.
프로젝트 설정 창에서 XR 플러그 인 관리 페이지와 유니버설 Windows 플랫폼 탭에 있는지 확인합니다.
시작 시 XR 초기화가 선택되어 있는지 확인하고 플러그 인 공급자에서 OpenXR을 클릭합니다.
OpenXR 플러그 인이 로드되고 OpenXR 아래에 여러 항목이 표시됩니다. Microsoft HoloLens 기능 그룹을 선택합니다.
OpenXR 옆에 노란색 경고 삼각형이 있습니다. 이는 해결해야 하는 호환되지 않는 설정이 있음을 나타냅니다. 이 문제를 해결하는 방법을 알아보려면 VR 구성에 대한 다음 섹션을 건너뛰고 호환되지 않는 설정 해결 섹션을 계속 진행합니다.
프로젝트 유효성 검사를 통해 데스크톱 VR용 프로젝트 구성(MR OpenXR 1.9 이상)
- 메뉴 모음에서 Mixed Reality > 프로젝트 유효성 검사 설정 > Win32 애플리케이션(독립 실행형)을 클릭하여 데스크톱 XR 앱에 대한 유효성 검사 규칙을 사용하도록 설정합니다.
- 팝업되는 프로젝트 유효성 검사 창에서 독립 실행형 플랫폼 탭에 있는지 확인하고 모두 수정을 클릭하여 유효성 검사 문제를 resolve. 모두 수정을 클릭한 후에도 문제가 남아 있을 수 있습니다. 이 경우 모두 수정 을 다시 클릭하고 "장면별"(있는 경우)으로 표시된 문제를 무시하고 나머지 문제(있는 경우)를 통해 변경하려는 제안된 변경 내용이 있는지 확인합니다.
데스크톱 VR에 대한 프로젝트를 수동으로 구성
프로젝트 설정 창이 열려 있는지 확인합니다. 그렇지 않은 경우 메뉴 모음으로 이동하여프로젝트 설정편집>을 선택합니다.
프로젝트 설정 창에서 XR 플러그 인 관리 페이지와 PC, Mac & Linux 독립 실행형 탭에 있는지 확인합니다.
시작 시 XR 초기화가 선택되어 있는지 확인하고 플러그 인 공급자에서 OpenXR을 클릭합니다.
OpenXR 플러그 인이 로드된 다음 OpenXR 아래에 2개의 항목이 표시됩니다. 첫 번째 기능 그룹 Windows Mixed Reality 선택합니다.
이제 OpenXR 옆에 노란색 경고 삼각형이 있습니다. 이는 해결해야 하는 호환되지 않는 설정이 있음을 나타냅니다. 이 문제를 해결하는 방법을 알아보려면 호환되지 않는 설정 해결의 다음 섹션을 계속 진행합니다.
호환되지 않는 설정 해결
중요
이 섹션의 이미지는 유니버설 Windows 플랫폼 탭의 옵션을 보여 줍니다. 그러나 지침은 설명된 경우를 제외하고 데스크톱 VR 탭에 대해 동일합니다.
OpenXR 옆에 있는 노란색 경고 삼각형 위로 커서를 가리킨 다음 팝업에서 메시지를 읽은 다음 삼각형을 선택합니다.
OpenXR 프로젝트 유효성 검사 창에 몇 가지 문제가 나열됩니다. 모두 수정 단추를 선택합니다. 참고: 이 목록은 사용자가 있는 탭에 따라 다르게 보일 수 있습니다.
한 가지 문제가 남으며 하나 이상의 상호 작용 프로필을 추가해야 한다고 알려 줍니다. 그러려면 편집을 클릭합니다. 그러면 프로젝트 설정 창의 OpenXR 플러그 인 설정으로 이동합니다.
상호 작용 프로필 아래에 더하기 기호(+) 단추가 있습니다.
각각 다른 프로필을 선택하면서 단추를 세 번 클릭합니다.
시선 응시 상호 작용 프로필
Microsoft 손 상호 작용 프로필
Microsoft 모션 컨트롤러 프로필
시선 응시 상호 작용 프로필 또는 다른 프로필이 옆에 노란색 삼각형과 함께 나타나면 삼각형을 선택한 다음 OpenXR 프로젝트 유효성 검사 창에서 수정 단추를 클릭합니다. 완료되면 OpenXR 프로젝트 유효성 검사 창을 닫습니다.
프로젝트 설정 창의 OpenXR 기능 그룹에서 다음이 선택되어 있는지 확인합니다.
데스크톱 VR 탭에 있는 경우:
Windows Mixed Reality
손 추적
모션 컨트롤러 모델
유니버설 Windows 플랫폼 탭에 있는 경우:
Microsoft HoloLens
손 추적
모션 컨트롤러 모델
깊이 제출 모드 드롭다운을 클릭한 다음 깊이 16비트를 선택합니다.
팁
깊이 형식을 16비트로 줄이는 것은 선택 사항이지만 프로젝트에서 그래픽 성능을 향상시킬 수 있습니다. 자세한 내용은 깊이 버퍼 공유(HoloLens)를 참조하세요.
참고
깊이 제출 모드 바로 위에 있는 렌더링 모드는 기본적으로 단일 패스 인스턴스로 설정됩니다. 혼합 현실 앱에서 장면은 왼쪽 눈과 오른쪽 눈을 위해 각각 한 번씩, 총 두 번 렌더링됩니다. 그 결과 "스테레오그래픽 비전"이 생성됩니다. 이렇게 하면 필요한 컴퓨팅의 양이 두 배로 늘어나므로 CPU 및 GPU 시간을 모두 절약하려면 Unity에서 가장 효율적인 렌더링 경로를 선택하는 것이 중요합니다. 단일 패스 인스턴스 렌더링이 여기에서 가장 좋은 선택입니다. 모든 프로젝트에서 기본적으로 사용하도록 설정하는 것이 좋습니다. 이에 대한 자세한 내용은 Unity 설명서를 참조하세요.
플레이어 설정 구성
Project 설정 창의 왼쪽 열에서 플레이어를 선택합니다.
플레이어 창에 제품 이름 상자가 이미 채워져 있습니다. 프로젝트 이름에서 가져온 것이며 HoloLens 시작 메뉴에 표시되는 이름이 됩니다.
팁
개발 중에 앱을 더 쉽게 찾을 수 있도록 이름 앞에 밑줄을 추가하여 목록의 맨 위에 표시합니다.
게시 설정 드롭다운을 클릭한 다음 패키지 이름 필드에 적절한 이름을 입력합니다.
참고
패키지 이름은 앱의 고유 식별자입니다. 이전에 설치된 앱 버전을 동일한 이름으로 덮어쓰는 것을 방지하려면 앱을 배포하기 전에 이 이름을 변경해야 합니다.
Project Settings(프로젝트 설정) 창을 닫습니다.
이제 Unity에서 OpenXR로 개발을 시작할 준비가 되었습니다.
Unity 샘플 프로젝트
Mixed Reality OpenXR 플러그 인을 사용하여 HoloLens 2 또는 Mixed Reality 헤드셋용 Unity 애플리케이션을 빌드하는 방법을 보여주는 샘플 Unity 프로젝트에 대한 OpenXR Mixed Reality 샘플 리포지토리를 확인하세요.