MRTK를 사용하여 새 OpenXR 프로젝트 설정

  • 아티클

혼합 현실에 대해 Unity 프로젝트를 설정하는 가장 쉬운 방법은 MRTK(Mixed Reality Toolkit)를 사용하는 것입니다. UNITY용 MRTK는 놀라운 혼합 현실 애플리케이션을 쉽게 빌드할 수 있도록 설계된 오픈 소스 플랫폼 간 개발 키트입니다.

Mixed Reality 도구 키트의 일부 기능을 보여 주는 인포그래픽.

MRTK는 플랫폼 간 입력 시스템, 기본 구성 요소 및 공간 상호 작용을 위한 공통 빌딩 블록을 제공합니다. 이를 통해 Microsoft HoloLens, Windows Mixed Reality 몰입형(VR) 헤드셋 및 기타 많은 VR/AR 디바이스에 대한 애플리케이션 개발 속도를 높일 수 있습니다. 이 프로젝트는 진입 장벽을 줄이고 모든 사람이 혼합 현실 애플리케이션을 구축하고 우리 모두가 성장함에 따라 지역 사회에 다시 기여할 수 있도록하는 것을 목표로합니다.

MRTK는 다음을 비롯한 다양한 플랫폼을 지원합니다.

  • Microsoft HoloLens

  • Microsoft HoloLens 2

  • Windows Mixed Reality 헤드셋

  • OpenVR 헤드셋(HTC Vive/Oculus Rift)

  • Ultraleap Hand Tracking

  • Android 및 iOS 디바이스

참고

최근에 다양한 OpenXR 규격 디바이스 및 새 디자인 언어를 더 잘 지원하여 Unity의 XR 관리 시스템 및 XR 상호 작용 도구 키트를 기반으로 구축된 Unity용 Microsoft Mixed Reality 도구 키트의 3세대 MRTK3을 도입했습니다. 자세한 내용은 MRTK3 설명서를 참조하세요.

참고

MRTK 없이 새 OpenXR 프로젝트를 설정할 수도 있습니다.

고려해야 할 기타 비 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 프로젝트 만들기

  1. 유니티 허브 시작합니다.

  2. 프로젝트 탭에서 새 프로젝트 클릭합니다.

    새 프로젝트 단추가 강조 표시된 프로젝트 탭의 Unity Hub 스크린샷

  3. 새 프로젝트 아래의 드롭다운을 클릭한 다음 원하는 편집기 버전을 선택합니다.

    편집기 버전 드롭다운이 표시된 Unity Hub 스크린샷

  4. 선택한 템플릿이 3D Core인지 확인합니다.

  5. 프로젝트 이름 상자에 프로젝트의 이름(예: “MRTK 자습서”)을 입력합니다.

  6. 위치 상자에서 폴더 아이콘을 클릭한 다음 프로젝트를 저장할 폴더로 이동하여 선택합니다. 필요에 따라 새 폴더를 만들 수도 있습니다.

    3D, Project Name(프로젝트 이름), Location(위치), Create(만들기)가 강조 표시된 Unity Hub의 스크린샷

  7. 프로젝트 만들기를 클릭합니다. 그러면 Unity에서 프로젝트가 열립니다.

    Unity에서 연 프로젝트의 스크린샷

주의

Windows에서 작업하는 경우 255자의 MAX_PATH 제한이 있습니다. Unity는 이러한 제한의 영향을 받으며, 파일 경로가 255자를 초과하는 경우 컴파일이 실패할 수 있습니다. 따라서 드라이브 루트와 최대한 가까운 위치에 Unity 프로젝트를 저장하는 것이 좋습니다.

빌드 대상 설정

  1. 메뉴 모음에서 File(파일)>Build Settings(빌드 설정)... 를 차례로 선택합니다.

    Windows Mixed Reality 위한 앱을 빌드하려면 빌드 대상을 선택해야 합니다. UWP(유니버설 Windows 플랫폼)에 대한 빌드 설정은 HP Reverb G2와 같은 몰입형 헤드셋을 포함한 모든 디바이스를 대상으로 합니다. 이는 HoloLens 2 위해 빌드하는 경우 가장 좋은 선택입니다. 그러나 데스크톱 VR을 대상으로 하는 경우 PC, Mac & Linux 독립 실행형 플랫폼을 사용하는 것이 좋습니다.

  2. 다음 중 하나를 수행합니다.

    데스크톱 VR을 대상으로 하는 경우:

    • 새 Unity 프로젝트에서 기본적으로 선택된 PC, Mac & Linux 독립 실행형 플랫폼을 유지합니다.

    PC, Mac & 독립 실행형 플랫폼이 강조 표시된 Unity 편집기에서 열린 빌드 설정 창의 스크린샷

    HoloLens 2 대상으로 하는 경우:

    • 플랫폼에서유니버설 Windows 플랫폼 선택합니다. 다음 설정이 활성 상태인지 확인합니다.

    빌드 형식: D3D Project

    대상 SDK 버전: 최신 설치됨

    최소 플랫폼 버전: 10.0.10240.0

    Visual Studio 버전: 최신 설치됨

    유니버설 Windows 플랫폼 강조 표시된 Unity 편집기에서 열린 빌드 설정 창의 스크린샷

  3. 플랫폼 전환 단추를 클릭합니다. Unity는 플랫폼을 전환하는 동안 진행률 표시줄을 표시합니다.

  4. 플랫폼 전환 프로세스가 완료되면 빌드 설정 창을 닫습니다.

Mixed Reality 기능 도구 다운로드 및 설치

Mixed Reality OpenXR 플러그 인은 Unity용 패키지 형식으로 제공됩니다. 기능 패키지를 검색, 업데이트 및 가져오는 가장 좋은 방법은 Mixed Reality 기능 도구를 사용하는 것입니다. 가져오기 전에 이름 또는 카테고리로 패키지를 검색하고, 종속성을 확인하고, 프로젝트 매니페스트 파일에 대한 제안된 변경 내용을 볼 수 있습니다.

  1. Microsoft 다운로드 센터에서 최신 버전의 Mixed Reality 기능 도구를 다운로드합니다.

  2. 다운로드가 완료되면 실행 파일 MixedRealityFeatureTool.exe 이동한 다음 이를 사용하여 Mixed Reality 기능 도구를 시작합니다.

    Mixed Reality Feature Tool 열기 스크린샷

Mixed Reality 도구 키트 및 OpenXR 패키지 가져오기

  1. Mixed Reality Feature Tool에서 시작을 선택합니다.

    Mixed Reality Feature Tool 열기 화면 스크린샷

  2. 찾아보기 단추(아래 이미지의 "점 세 개" 단추)를 선택하여 프로젝트로 이동한 다음 프로젝트를 엽니다.

    프로젝트 열기

    참고

    도구의 프로젝트 경로 상자에는 값이 포함되어야 하므로 기본적으로 백슬래시("_")를 삽입합니다.

    폴더를 선택한 후 Tool은 올바른 Unity 프로젝트 폴더인지 확인합니다.

    Mixed Reality Feature Tool 프로젝트 경로 창의 스크린샷

  3. 기능 검색을 선택합니다.

    참고: Tool이 피드에서 패키지를 새로 고치는 동안 몇 초 정도 기다려야 할 수 있습니다.

  4. 기능 검색 페이지에 6개의 패키지 그룹 목록이 있습니다.

    Mixed Reality Feature Tool의 기본 패키지 그룹

  5. Mixed Reality Toolkit(0/10) 왼쪽에 있는 “+” 단추를 클릭한 다음 최신 버전의 Mixed Reality Toolkit Foundation을 선택합니다.

    참고

    Mixed Reality Toolkit Foundation 패키지는 프로젝트에 MRTK를 사용하려면 가져와 구성해야 하는 유일한 패키지입니다. 이 패키지에는 혼합 현실 애플리케이션을 만드는 데 필요한 핵심 구성 요소가 포함되어 있습니다.

  6. 플랫폼 지원(0/5) 왼쪽에 있는 “+” 단추를 클릭한 다음 최신 버전의 Mixed Reality OpenXR 플러그 인을 선택합니다.

    Mixed Reality Feature Tool의 패키지 선택 스크린샷

  7. 선택한 후 기능 가져오기를 클릭합니다.

  8. 유효성 검사를 선택하여 선택한 패키지의 유효성을 검사합니다. 유효성 검사 문제가 발견되지 않았습니다라는 대화 상자가 표시됩니다. 표시되면 확인을 클릭합니다.

  9. 기능 가져오기 페이지에서 왼쪽의 기능 열에 방금 선택한 패키지가 표시됩니다. 오른쪽의 필수 종속성 열에 종속성이 표시됩니다. 이러한 항목의 세부 정보 링크를 클릭하여 해당 항목에 대해 자세히 알아볼 수 있습니다.

  10. 계속 진행할 준비가 되면 가져오기를 선택합니다. 검토 및 승인 페이지에서 패키지에 대한 정보를 검토할 수 있습니다.

  11. 승인을 선택합니다.

  12. Unity 편집기로 돌아와 UI의 빈 영역을 클릭합니다. 패키지를 가져오고 있음을 보여 주는 진행률 표시줄을 볼 수 있습니다.

입력 백 엔드 설정 구성

  1. Unity에서 패키지를 가져온 후 편집기를 다시 시작하여 백 엔드를 사용하도록 설정할지 묻는 경고가 나타납니다. 예를 선택합니다.

    Unity 다시 시작 옵션의 스크린샷

프로젝트 유효성 검사를 통해 HoloLens 2 프로젝트 구성(MR OpenXR 1.6 이상)

데스크톱 VR용으로 개발하는 경우 이 섹션을 건너뛰고 데스크톱 VR용 프로젝트 구성으로 이동합니다.

  1. 메뉴 모음에서 Mixed Reality > 프로젝트 유효성 검사 설정 > HoloLens 2 애플리케이션(UWP)을 클릭하여 HoloLens 2 유효성 검사 규칙을 사용하도록 설정합니다. 버전 1.9 이전의 MR OpenXR 플러그 인의 경우 사용할 수 있는 메뉴 항목은 HoloLens 2 > 프로젝트 > 적용 권장 프로젝트 설정을 Mixed Reality.
  2. 팝업되는 프로젝트 유효성 검사 창에서 UWP 플랫폼 탭(Windows 로고로 표시됨)에 있는지 확인하고 모두 수정을 클릭하여 유효성 검사 문제를 resolve. 모두 수정을 클릭한 후에도 문제가 남아 있을 수 있습니다. 이 경우 모두 수정 을 다시 클릭하고 "장면별"(있는 경우)으로 표시된 문제를 무시하고 나머지 문제(있는 경우)를 통해 변경하려는 제안된 변경 내용이 있는지 확인합니다.
  3. 이 시점에서 프로젝트는 HoloLens 2 배포할 준비가 거의 완료되었습니다. 다음 단계를 위해 플레이어 설정 구성 을 진행합니다.

수동으로 HoloLens 2 프로젝트 구성

데스크톱 VR용으로 개발하는 경우 이 섹션을 건너뛰고 데스크톱 VR용 프로젝트 구성으로 이동합니다.

  1. 프로젝트 설정 창이 열려 있는지 확인합니다. 그렇지 않은 경우 메뉴 모음에서프로젝트 설정편집>을 선택합니다.

  2. 프로젝트 설정 창에서 XR 플러그 인 관리 페이지와 유니버설 Windows 플랫폼 탭에 있는지 확인합니다.

    XR 플러그 인 관리 페이지 및 유니버설 Windows 플랫폼 탭에 열려 있는 프로젝트 설정 창의 스크린샷

  3. 시작 시 XR 초기화가 선택되어 있는지 확인하고 플러그 인 공급자에서 OpenXR을 클릭합니다.

    시작 시 XR 초기화가 선택되고 OpenXR 플러그 인이 강조 표시된 유니버설 Windows 플랫폼 내의 프로젝트 설정 창 스크린샷

  4. OpenXR 플러그 인이 로드되고 OpenXR 아래에 여러 항목이 표시됩니다. Microsoft HoloLens 기능 그룹을 선택합니다.

    OpenXR 플러그 인과 Microsoft HoloLens 기능 그룹이 강조 표시된 프로젝트 설정 창의 스크린샷

OpenXR 옆에 노란색 경고 삼각형이 있습니다. 이는 해결해야 하는 호환되지 않는 설정이 있음을 나타냅니다. 이 문제를 해결하는 방법을 알아보려면 VR 구성에 대한 다음 섹션을 건너뛰고 호환되지 않는 설정 해결 섹션을 계속 진행합니다.

프로젝트 유효성 검사를 통해 데스크톱 VR용 프로젝트 구성(MR OpenXR 1.9 이상)

  1. 메뉴 모음에서 Mixed Reality > 프로젝트 유효성 검사 설정 > Win32 애플리케이션(독립 실행형)을 클릭하여 데스크톱 XR 앱에 대한 유효성 검사 규칙을 사용하도록 설정합니다.
  2. 팝업되는 프로젝트 유효성 검사 창에서 독립 실행형 플랫폼 탭에 있는지 확인하고 모두 수정을 클릭하여 유효성 검사 문제를 resolve. 모두 수정을 클릭한 후에도 문제가 남아 있을 수 있습니다. 이 경우 모두 수정 을 다시 클릭하고 "장면별"(있는 경우)으로 표시된 문제를 무시하고 나머지 문제(있는 경우)를 통해 변경하려는 제안된 변경 내용이 있는지 확인합니다.

데스크톱 VR에 대한 프로젝트를 수동으로 구성

  1. 프로젝트 설정 창이 열려 있는지 확인합니다. 그렇지 않은 경우 메뉴 모음으로 이동하여프로젝트 설정편집>을 선택합니다.

  2. 프로젝트 설정 창에서 XR 플러그 인 관리 페이지와 PC, Mac & Linux 독립 실행형 탭에 있는지 확인합니다.

    XR 플러그 인 관리 페이지 및 PC, Mac & Linux 독립 실행형 탭에 열려 있는 프로젝트 설정 창의 스크린샷

  3. 시작 시 XR 초기화가 선택되어 있는지 확인하고 플러그 인 공급자에서 OpenXR을 클릭합니다.

    시작 시 XR 초기화가 선택되고 OpenXR 플러그 인이 강조 표시된 PC 내의 프로젝트 설정 창, Mac & Linux 독립 실행형 탭의 스크린샷

  4. OpenXR 플러그 인이 로드된 다음 OpenXR 아래에 2개의 항목이 표시됩니다. 첫 번째 기능 그룹 Windows Mixed Reality 선택합니다.

    OpenXR 플러그 인 및 Windows Mixed Reality 기능 그룹이 강조 표시된 프로젝트 설정 창의 스크린샷

이제 OpenXR 옆에 노란색 경고 삼각형이 있습니다. 이는 해결해야 하는 호환되지 않는 설정이 있음을 나타냅니다. 이 문제를 해결하는 방법을 알아보려면 호환되지 않는 설정 해결의 다음 섹션을 계속 진행합니다.

호환되지 않는 설정 해결

중요

이 섹션의 이미지는 유니버설 Windows 플랫폼 탭의 옵션을 보여 줍니다. 그러나 지침은 설명된 경우를 제외하고 데스크톱 VR 탭에 대해 동일합니다.

  1. OpenXR 옆에 있는 노란색 경고 삼각형 위로 커서를 가리킨 다음 팝업에서 메시지를 읽은 다음 삼각형을 선택합니다.

    호환되지 않는 설정에 대한 경고 스크린샷

  2. OpenXR 프로젝트 유효성 검사 창에 몇 가지 문제가 나열됩니다. 모두 수정 단추를 선택합니다. 참고: 이 목록은 사용자가 있는 탭에 따라 다르게 보일 수 있습니다.

    OpenXR 프로젝트 유효성 검사 창에 있는 모두 수정 단추의 스크린샷

  3. 한 가지 문제가 남으며 하나 이상의 상호 작용 프로필을 추가해야 한다고 알려 줍니다. 그러려면 편집을 클릭합니다. 그러면 프로젝트 설정 창의 OpenXR 플러그 인 설정으로 이동합니다.

    OpenXR 설정이 표시된 프로젝트 설정 창의 스크린샷

  4. 상호 작용 프로필 아래에 더하기 기호(+) 단추가 있습니다.

    상호 작용 프로필 추가 단추의 스크린샷

  5. 각각 다른 프로필을 선택하면서 단추를 세 번 클릭합니다.

    시선 응시 상호 작용 프로필

    Microsoft 손 상호 작용 프로필

    Microsoft 모션 컨트롤러 프로필

    추가해야 하는 상호 작용 프로필의 스크린샷

    시선 응시 상호 작용 프로필 또는 다른 프로필이 옆에 노란색 삼각형과 함께 나타나면 삼각형을 선택한 다음 OpenXR 프로젝트 유효성 검사 창에서 수정 단추를 클릭합니다. 완료되면 OpenXR 프로젝트 유효성 검사 창을 닫습니다.

    상호 작용 프로필에 수정 단추의 스크린샷

  6. 프로젝트 설정 창의 OpenXR 기능 그룹에서 다음이 선택되어 있는지 확인합니다.

    데스크톱 VR 탭에 있는 경우:

    Windows Mixed Reality

    손 추적

    모션 컨트롤러 모델

    데스크톱 VR 탭에 대한 OpenXR 기능 그룹의 스크린샷

    유니버설 Windows 플랫폼 탭에 있는 경우:

    Microsoft HoloLens

    손 추적

    모션 컨트롤러 모델

    OpenXR에서 선택된 기능의 스크린샷

  7. 깊이 제출 모드 드롭다운을 클릭한 다음 깊이 16비트를 선택합니다.

    깊이 제출 모드에서 선택된 깊이 16비트의 스크린샷

    팁

    깊이 형식을 16비트로 줄이는 것은 선택 사항이지만 프로젝트에서 그래픽 성능을 향상시킬 수 있습니다. 자세한 내용은 깊이 버퍼 공유(HoloLens)를 참조하세요.

    참고

    깊이 제출 모드 바로 위에 있는 렌더링 모드는 기본적으로 단일 패스 인스턴스로 설정됩니다. 혼합 현실 앱에서 장면은 왼쪽 눈과 오른쪽 눈을 위해 각각 한 번씩, 총 두 번 렌더링됩니다. 그 결과 "스테레오그래픽 비전"이 생성됩니다. 이렇게 하면 필요한 컴퓨팅의 양이 두 배로 늘어나므로 CPU 및 GPU 시간을 모두 절약하려면 Unity에서 가장 효율적인 렌더링 경로를 선택하는 것이 중요합니다. 단일 패스 인스턴스 렌더링이 여기에서 가장 좋은 선택입니다. 모든 프로젝트에서 기본적으로 사용하도록 설정하는 것이 좋습니다. 이에 대한 자세한 내용은 Unity 설명서를 참조하세요.

플레이어 설정 구성

  1. Project 설정 창의 왼쪽 열에서 플레이어를 선택합니다.

  2. 플레이어 창에 제품 이름 상자가 이미 채워져 있습니다. 이 이름은 프로젝트 이름에서 가져온 것이며 HoloLens 시작 메뉴에 표시되는 이름이 됩니다.

    프로젝트 이름 상자가 채워진 Unity 게시 설정의 스크린샷

    팁

    개발 중에 앱을 더 쉽게 찾을 수 있도록 이름 앞에 밑줄을 추가하여 목록의 맨 위에 표시합니다.

  3. 게시 설정 드롭다운을 클릭한 다음 패키지 이름 필드에 적절한 이름을 입력합니다.

    패키지 이름 상자가 채워진 Unity 게시 설정의 스크린샷

    참고

    패키지 이름은 앱의 고유 식별자입니다. 이전에 설치된 앱 버전을 동일한 이름으로 덮어쓰는 것을 방지하려면 앱을 배포하기 전에 이 이름을 변경해야 합니다.

  4. Project Settings(프로젝트 설정) 창을 닫습니다.

이제 Unity에서 OpenXR로 개발을 시작할 준비가 되었습니다!

Unity 샘플 프로젝트

Mixed Reality OpenXR 플러그 인을 사용하여 HoloLens 2 또는 Mixed Reality 헤드셋용 Unity 애플리케이션을 빌드하는 방법을 보여주는 샘플 Unity 프로젝트에 대한 OpenXR Mixed Reality 샘플 리포지토리를 확인하세요.

추가 정보