Unity 용 Mixed Reality OpenXR 플러그 인 사용Using the Mixed Reality OpenXR Plugin for Unity

Unity 버전 2020.2부터 Microsoft의 Mixed Reality OpenXR 플러그 인 패키지는 UPM (Unity 패키지 관리자)를 사용 하 여 사용할 수 있습니다.Starting with Unity version 2020.2, Microsoft’s Mixed Reality OpenXR Plugin package is available using the Unity Package Manager (UPM).

전제 조건Prerequisites

  • Unity 2020.2 이상Unity 2020.2 or later
  • Unity OpenXR plugin 0.1.2 이상Unity OpenXR plugin 0.1.2 or later
  • Visual Studio 2019 이상Visual Studio 2019 or later
  • HoloLens 2 앱 용 Unity에서 UWP 플랫폼 지원 설치Install UWP platform support in Unity for HoloLens 2 apps

참고

Windows PC에서 VR 응용 프로그램을 작성 하는 경우 Mixed Reality OpenXR 플러그 인이 반드시 필요한 것은 아닙니다.If you're building VR applications on Windows PC, the Mixed Reality OpenXR plugin is not necessarily required. 그러나 HP 반향 G2 컨트롤러에 대 한 컨트롤러 매핑을 사용자 지정 하거나 HoloLens 2와 VR 헤드셋 모두에서 작동 하는 앱을 빌드하는 경우에는 플러그 인을 설치 하는 것이 좋습니다.However, you'll want to install the plugin if you're customizing controller mapping for HP Reverb G2 controllers or building apps that work on both HoloLens 2 and VR headsets.

Mixed Reality OpenXR 플러그 인 설치Installing the Mixed Reality OpenXR plugin

혼합 현실 OpenXR 플러그 인을 사용 하기 전에 프로젝트에서 OpenXR 플러그 인 및 XR 플러그 인 관리 패키지를 설치 해야 합니다.Your project needs to install the OpenXR Plugin and XR Plugin Management packages before using the Mixed Reality OpenXR Plugin. 이미 설치한 경우 좋은 방법입니다!If you've already installed them, great! 그렇지 않으면 Mixed Reality OpenXR 플러그 인을 설치 하면 자동으로 종속성으로 설치 됩니다.If not, installing the Mixed Reality OpenXR plugin will automatically install them as dependencies:

  1. Unity 편집기에서 편집 > 프로젝트 설정 > 패키지 관리자 로 이동 합니다.In the Unity Editor, navigate to Edit > Project Settings > Package Manager

  2. 범위가 지정 된 레지스트리 섹션을 확장 하 고, 다음 정보를 입력 하 고, 저장 을 선택 합니다.Expand the Scoped Registries section, enter the following information, and select Save:

  3. 고급 설정 아래에서 미리 보기 패키지 사용 을 선택 합니다.Under Advanced Settings, select Enable Preview Packages

프로젝트 설정에서 열려 있는 Unity 패키지 관리자 창의 스크린샷

Unity 패키지 관리자는 manifest.js 이라는 매니페스트 파일을 사용 하 여 설치할 패키지와 설치할 수 있는 패키지를 확인 합니다.The Unity Package Manager uses a manifest file named manifest.json to determine which packages to install and the registries they can be installed from.

중요

OpenXR는 Unity에서 여전히 실험적 이며 개발자 환경을 최적화 하기 위해이 프로세스는 시간이 지남에 따라 변경 될 수 있습니다.OpenXR is still experimental in Unity and this process may change over time as we work to optimize the developer experience.

Mixed Reality 종속성 등록Registering the Mixed Reality dependency

Microsoft Mixed Reality 범위 레지스트리가 매니페스트에 추가 된 후에는 OpenXR 패키지를 지정할 수 있습니다.Once the Microsoft Mixed Reality scoped registry has been added to the manifest, the OpenXR package can be specified.

OpenXR 패키지를 추가 하려면:To add the OpenXR package:

  1. Visual Studio Code와 같은 텍스트 편집기에서 [Projectroot]/Packages/manifest.js을 엽니다.Open [projectRoot]/Packages/manifest.json in a text editor like Visual Studio Code

    1. 여기를 보려면 프로젝트 창의 왼쪽 패널에서 패키지 를 마우스 오른쪽 단추로 클릭 합니다.To get here, right click on Packages in the left panel of the Project window. 그런 다음 탐색기에서 표시 를 클릭 합니다.Then, click Show in Explorer. 프로젝트 창에 나열 된 패키지의 스크린샷Screenshot of the packages listing in the Project window
  2. 다음과 같이 파일 에서 패키지/manifest.js 의 종속성 섹션을 수정 합니다.Modify the dependencies section of the Packages/manifest.json file as follows:

    중요

    매니페스트 파일에는 여기에 표시 된 것 보다 더 많은 종속성이 있을 수 있습니다.There may be more dependencies in your manifest file than shown here. 이러한 항목을 삭제 하지 않고 OpenXR 종속성을 목록에 추가 하기만 하면 됩니다.Don't delete any of them, just add the OpenXR dependency to the list.

      "dependencies": {
        "com.microsoft.mixedreality.openxr": "0.1.2",
      }
    
  3. 파일을 저장 하 고 Unity 편집기로 다시 전환한 후 패키지 관리자 를 열어 플러그 인이 설치 되었는지 확인 합니다.Save the file, switch back to the Unity Editor, and open the Package Manager to confirm the plugin is installed:

    혼합 현실 OpenXR 플러그 인이 강조 표시 된 unity 편집기에서 열리는 Unity 패키지 관리자의 스크린샷

    참고

    Unity 패키지 관리자를 사용 하 여 OpenXR 패키지를 제거 하는 경우 앞에서 설명한 단계를 사용 하 여 패키지를 다시 추가 해야 합니다.If the OpenXR package is removed using the Unity Package Manager, you'll have to re-add it using the previously described steps.

OpenXR에 대 한 XR 플러그 인 관리 구성Configuring XR Plugin Management for OpenXR

OpenXR을 Unity에서 런타임으로 설정 하려면 다음을 수행 합니다.To set OpenXR as the the runtime in Unity:

  1. Unity 편집기에서 편집 > 프로젝트 설정 으로 이동 합니다.In the Unity Editor, navigate to Edit > Project Settings
  2. 설정 목록에서 XR 플러그 인 관리 를 선택 합니다.In the list of Settings, select XR Plugin Management
  3. INITIALIZE XR On Startup and OpenXR (미리 보기) 상자를 선택 합니다.Check the Initialize XR on Startup and OpenXR (Preview) boxes
  4. HoloLens 2를 대상으로 하는 경우 UWP 플랫폼에 있는지 확인 하 고 Microsoft HoloLens 기능 집합 을 선택 합니다.If targeting HoloLens 2, make sure you're on the UWP platform and select Microsoft HoloLens Feature Set

XR 플러그 인 관리를 강조 표시 한 Unity 편집기에서 열리는 프로젝트 설정 패널의 스크린샷

중요

OpenXR 플러그 인 (미리 보기) 옆에 빨간색 경고 아이콘이 표시 되는 경우 계속 하기 전에 아이콘을 클릭 하 고 모두 수정 을 선택 합니다.If you see a red warning icon next to OpenXR Plugin (Preview), click the icon and select Fix all before continuing. Unity 편집기를 다시 시작 해야 변경 내용이 적용 될 수 있습니다.The Unity Editor may need to restart itself for the changes to take effect.

OpenXR 프로젝트 유효성 검사 창의 스크린샷

이제 Unity에서 OpenXR를 사용 하 여 개발을 시작할 준비가 되었습니다.You're now ready to begin developing with OpenXR in Unity! OpenXR 샘플을 사용 하는 방법을 알아보려면 다음 섹션을 계속 진행 합니다.Continue on to the next section to learn how to use the OpenXR samples.

OptimizationOptimization

HoloLens 2 용으로 개발 하는 경우 > OpenXR> Mixed Reality로 이동 하 여 hololens 2에 권장 되는 프로젝트 설정을 적용 하 여 더 나은 앱 성능을 얻을 수 있습니다.If you're developing for HoloLens 2, navigate to Mixed Reality> OpenXR > Apply recommended project settings for HoloLens 2 to get better app performance.

OpenXR가 선택 된 혼합 현실 메뉴 항목 열기의 스크린샷

Unity 샘플 장면을 사용해 보세요.Try out the Unity sample scenes

하나 이상의 예제를 활용 하려면 패키지 관리자 에서 arfoundation 4.0 + 를 설치 합니다.To utilize one or more of the examples, install ARFoundation 4.0+ from the Package Manager:

AR가 강조 표시 된 unity 편집기에서 open Unity 패키지 관리자의 스크린샷

HoloLens 2 샘플HoloLens 2 samples

  1. Unity 편집기에서 창 > 패키지 관리자 로 이동 합니다.In the Unity Editor, navigate to Window > Package Manager
  2. 패키지 목록에서 Mixed Reality OpenXR 플러그 인 을 선택 합니다.In the list of packages, select Mixed Reality OpenXR Plugin
  3. 샘플 목록에서 샘플을 찾고 가져오기 를 선택 합니다.Locate the sample in the Samples list and select Import

Unity 편집기에서 open Reality OpenXR 플러그 인을 선택 하 고 샘플 가져오기 단추가 강조 표시 된 Unity 패키지 관리자의 스크린샷

참고

패키지가 업데이트 되 면 Unity는 가져온 샘플을 업데이트 하는 옵션을 제공 합니다.When a package is updated, Unity provides the option to update imported samples. 가져온 샘플을 업데이트 하면 샘플 및 연결 된 자산에 대 한 모든 변경 내용이 덮어쓰여집니다.Updating an imported sample will overwrite any changes that have been made to the sample and associated assets.

OpenXR 지원과 함께 MRTK 사용Using MRTK with OpenXR support

MRTK Unity는 2.5.3 릴리스로 시작 하는 Mixed Reality OpenXR 플러그 인을 지원 합니다.MRTK Unity supports the Mixed Reality OpenXR plugin starting with the 2.5.3 release. MRTK 플러그 인은 Mixed Reality OpenXR 플러그 인을 설치할때 설정 하는 것과 동일한 범위의 레지스트리에서 설치할 수 있습니다.MRTK plugins can be installed from the same scoped registries as you set up when installing the Mixed Reality OpenXR plugin. Mrtk 설명서에서 더 자세한 정보를 찾을 수 있습니다.You can find more detailed information in the MRTK documentation.

  1. 파일 의 [Projectroot]/Packages/manifest.js 에서 다음 패키지를 추가 합니다.Add following packages in your [projectRoot]/Packages/manifest.json file:
"dependencies": {
    "com.microsoft.mixedreality.toolkit.foundation": "2.5.3",
    "com.microsoft.mixedreality.toolkit.tools": "2.5.3",
    "com.microsoft.mixedreality.toolkit.examples": "2.5.3",
    …
}
  1. 검사기에서 MixedReality Toolkit 구성 요소 스크립트로 이동 하 고 Defaultopenxrconfigurationprofile 프로필로 전환 합니다.Go to the MixedReality Toolkit component script in the Inspector and switch to the DefaultOpenXRConfigurationProfile profile:

검사기의 Mixed Reality Toolkit 구성 요소에서 MRTK 구성 전환 스크린샷

알려진 문제Known issues

손으로 추적 기능을 사용 하는 경우 자산/MixedRealityToolkit/link.xml 파일에 다음 줄을 추가 합니다.When using the Hand Tracking feature, add following line in the Assets/MixedRealityToolkit.Generated/link.xml file:

<assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.OpenXR" preserve="all"/>

다음 단계Next steps

이제 OpenXR에 대해 프로젝트를 구성 하 고 샘플에 액세스할 수 있으므로, OpenXR 플러그 인에서 현재 지원 되는 기능 을 확인 하세요.Now that you have your project configured for OpenXR and have access to samples, check out what features are currently supported in our OpenXR plugin.

피드백이 있나요?Have Feedback?

OpenXR는 여전히 실험적 이므로 피드백을 제공 하는 데 도움이 되도록 피드백을 보내 주셔서 감사 합니다.OpenXR is still experimental, so we’d appreciate any feedback you can give us to help make it better. Microsoft + OpenXRHoloLens 2 또는 Windows Mixed Reality 를 사용 하 여 포럼 게시물에 태그를 지정 하 여 Unity 포럼에서이를 찾을 수 있습니다.You'll find us on the Unity Forums by tagging your forum post with Microsoft + OpenXR and either HoloLens 2 or Windows Mixed Reality.

참조See also