OpenXR 런타임

OpenXR 런타임을 설치하고 OpenXR 프로젝트를 구성하는 방법을 알아봅니다.

Choose your operating system:

Windows

macOS

Linux

언리얼 엔진(UE)에서 디바이스의 OpenXR을 사용하여 개발하려면 플랫폼에 맞는 OpenXR 런타임을 설치해야 합니다. 다음 섹션에서는 올바른 OpenXR 런타임을 설치하는 방법과 각 플랫폼에 필요한 플러그인이 무엇인지 다룹니다.

현재 UE의 플랫폼별 플러그인 중 일부는 OpenXR 플러그인과 호환되지 않습니다. 언리얼 프로젝트에서 OpenXR 플러그인을 사용할 때 Oculus 및 Windows Mixed Reality 플러그인을 비활성화해야 합니다. 향후 출시 버전에서는 플랫폼 플러그인을 간소화하고 Oculus OpenXR과 Oculus 플러그인을 결합할 계획입니다.

Windows Mixed Reality

언리얼 에디터에서 OpenXR과 함께 Windows Mixed Reality 디바이스 사용을 시작하려면 다음 항목을 완료합니다.

  • Microsoft의 OpenXR 시작 문서의 단계를 완료하여 컴퓨터에 Windows Mixed RealityOpenXR 런타임을 설치합니다.

  • 언리얼 프로젝트에서 Windows Mixed Reality 플러그인을 비활성화합니다.

  • 언리얼 프로젝트에서 OpenXR 플러그인을 활성화합니다.

    HoloLens

    언리얼 에디터에서 OpenXR과 함께 HoloLens 디바이스 사용을 시작하려면 다음 항목을 완료합니다.

  • HoloLens 전제조건의 단계를 완료하여 컴퓨터와 디바이스를 구성합니다.

  • 언리얼 프로젝트에서 Windows Mixed Reality 플러그인을 비활성화합니다.

  • 언리얼 프로젝트에서 OpenXR 플러그인을 활성화합니다.

  • 언리얼 프로젝트에서 HoloLens 플러그인을 활성화합니다.

  • HoloLens에 최신 OpenXR 런타임 을 설치합니다. Microsoft 문서의 지침을 따라 디바이스에서 OpenXR 런타임을 업데이트합니다.

HoloLens Remoting은 현재 Windows Mixed Reality 플러그인에서만 지원됩니다. OpenXR 프로젝트에서 Windows Mixed Reality 플러그인이 비활성화되어야 하므로 프로젝트를 패키징하고 디바이스에 설치하여 HoloLens를 타깃으로 하는 OpenXR 프로젝트만 테스트할 수 있습니다.

Oculus

언리얼 에디터에서 OpenXR과 함께 Oculus 디바이스 사용을 시작하려면 다음 항목을 완료합니다.

  • Oculus 전제조건의 단계를 완료하여 컴퓨터와 디바이스를 구성합니다.

  • 언리얼 프로젝트에서 Oculus 플러그인을 비활성화합니다.

  • 언리얼 프로젝트에서 OpenXR 플러그인을 활성화합니다.

  • Oculus 앱에서 퍼블릭 테스트 채널에 등록하고 컴퓨터에 OpenXR runtime for Oculus 를 설치합니다.

컴퓨터에 다른 OpenXR 런타임이 있는 경우 언리얼 엔진에서 OpenXR runtime for Oculus를 찾을 수 있도록 환경 변수를 설정해야 합니다. OpenXR runtime for Oculus를 필요로 하지 않는 다른 디바이스를 사용하려면 환경 변수를 제거해야 합니다. 아래 지침에서는 Windows 컴퓨터에서 필요한 환경 변수를 설정하는 방법을 보여줍니다.

  1. 시스템 속성(System Properties) 창을 엽니다.

  2. 고급(Advanced) 탭에서 환경 변수...(Environment Variables…) 버튼을 클릭하고 환경 변수(Environment Variables) 창을 엽니다. 시스템 속성 고급 탭

  3. 환경 변수(Environment Variables) 창의 시스템 변수(System variables) 섹션에서 새로 만들기…(New...) 를 선택하고 새 시스템 변수(New System Variable) 창을 엽니다. 환경 변수 시스템 섹션

  4. 새 시스템 변수(New System Variable) 창에서 다음을 설정합니다.

    1. 변수 이름(Variable name)XR_RUNTIME_JSON 으로 설정합니다.

    2. 변수 값(Variable value)C:\Program Files\Oculus\Support\oculus-runtime\oculus_openxr_64.json 으로 설정합니다. 새 시스템 변수

  5. 새 시스템 변수(New System Variable) 창에서 확인(OK) 을 클릭하여 새 시스템 변수를 생성합니다.

  6. 시스템 변수(System variables) 목록에서 검색하여 새 환경 변수가 적절하게 생성되었는지 확인합니다. 새 시스템 변수가 추가된 환경 변수 시스템 섹션

SteamVR

언리얼 에디터에서 OpenXR과 함께 SteamVR 디바이스 사용을 시작하려면 다음 항목을 완료합니다.

  • SteamVR 전제조건의 단계를 완료하여 컴퓨터와 디바이스를 구성합니다.

  • 언리얼 프로젝트에서 OpenXR 플러그인을 활성화합니다.