지원되는 헤드셋
이 페이지에서는 QtQuick3D.Xr이 테스트되고 지원되는 플랫폼 및 장치에 대해 간략하게 설명합니다.
참고: QtQuick3D.Xr은 아직 개발 중이며 일부 플랫폼에서 모든 기능을 사용하지 못할 수도 있습니다.
기본 Xr 플랫폼 개념
QtQuick3D.Xr은 두 가지 주요 플랫폼을 지원합니다. 애플리케이션 개발을 위한 API로 OpenXR을 사용하는 디바이스와 Apple의 비전OS를 사용하는 디바이스입니다.
OpenXR
OpenXR은 XR 애플리케이션 개발을 위한 공통 API 세트를 제공하는 개방형 표준입니다. OpenXR의 구현은 Android 또는 Windows와 같은 다양한 플랫폼에서 사용할 수 있습니다.
일부 VR/AR 기기는 자체적으로 완전한 애플리케이션 배포 및 런타임 플랫폼입니다. 예를 들어 메타 퀘스트 3는 완전하고 독립적인 Android 기반 기기입니다. 애플리케이션 개발자의 관점에서 보면 워크플로우는 Android 휴대폰 및 태블릿용 개발과 매우 유사합니다. 이러한 디바이스와 해당 소프트웨어 플랫폼을 Standalone VR
이라고도 합니다.
다른 헤드셋은 전체 애플리케이션 배포 및 런타임 플랫폼을 제공하지 않고, 애플리케이션 렌더링 콘텐츠가 유선 또는 무선 연결을 통해 헤드셋으로 스트리밍되는 일반적으로 Windows 또는 Linux를 실행하는 컴퓨터와 결합하여 사용합니다. 이 설정을 PCVR
이라고도 합니다. 이 경우 애플리케이션은 일반 데스크톱 Windows 또는 Linux 애플리케이션으로 개발 및 배포됩니다. 하지만 일반적인 데스크톱 애플리케이션처럼 화면 창을 열어 콘텐츠를 표시하는 대신 OpenXR과 Direct 3D 또는 Vulkan과 같은 3D API를 통해 화면 밖 버퍼로 렌더링합니다. 결과 콘텐츠는 헤드셋으로 스트리밍되어 표시되며, 실제 스트리밍 및 관련 처리는 기본 소프트웨어 스택에서 Qt와 애플리케이션에 투명하게 관리됩니다. 이러한 헤드셋의 예로는 Varjo의 일부 장치 또는 HTC Vive 제품군의 비독립형 장치가 있습니다.
일부 기기는 두 가지 범주 모두에 속합니다. 특히 메타 퀘스트 3는 두 가지 작동 모드를 모두 지원합니다.
독립형 디바이스의 경우 모든 렌더링과 처리가 헤드셋 자체에서 이루어집니다. OpenXR과 기본 런타임 환경의 단일 구현이 있으며, 애플리케이션이 디바이스에서 실행될 때 이를 사용합니다.
비독립형 디바이스에서는 모든 렌더링과 대부분의 관련 처리가 호스트 PC에서 이루어집니다. 품질과 성능은 호스트 PC의 기능에 크게 좌우되지만 스트리밍 기술 및 무선 네트워크 대역폭과 같은 관련 요소도 결과에 영향을 미칠 수 있습니다. PCVR 세계에는 OpenXR 구현과 유선 또는 무선 스트리밍을 제공하는 여러 솔루션이 있습니다.
참고: OpenXR은 개방형 표준이기 때문에 호환되는 기기는 Qt에서 테스트 및 검증하지 않은 기기라도 작동할 수 있습니다. 즉, 모든 기능과 호환성을 즉시 보장할 수는 없습니다.
OpenXR 기반이 아닌 디바이스 및 플랫폼
Qt Quick 3D Xr은 현재 OpenXR이 아닌 한 가지 플랫폼을 지원합니다: Apple의 비전OS. Apple Vision Pro와 같은 기기는 Standalone VR
범주에 속합니다.
테스트 및 검증된 헤드셋, 티어 1
Qt에서 정기적으로 테스트 및 검증하고 Qt Quick 3D Xr 개발 중에 활발하게 사용되는 장치 목록입니다.
- 메타 퀘스트 3, 독립형(Android)
- 메타 퀘스트 3, PCVR 모드(Windows)
- Apple Vision Pro, 스탠드얼론(비전OS)
테스트 및 검증된 헤드셋, 티어 2
이 목록은 Qt Quick 3D Xr 개발 중에 가끔씩 테스트되는 추가 장치 목록이며, 작동을 기대할 수 있지만 완전한 기능을 보장할 수는 없습니다.
- 메타 퀘스트 2, 독립형(Android)
- PCVR 모드의 HTC Vive(Linux)
특별 개발자 환경
다음은 Qt Quick 3D Xr 개발 시 사용되는 VR 시뮬레이터 솔루션 목록으로, 애플리케이션 개발자에게도 유용할 수 있습니다. 이러한 솔루션에서는 특히 AR 기능의 경우 전체 기능이 보장되지 않습니다.
- 메타 XR 시뮬레이터 (Windows). 데스크톱 창에서 렌더링된 콘텐츠를 왼쪽과 오른쪽 눈에 별도로 표시하는 동시에 입력 컨트롤러 시뮬레이션 및 기타 여러 개발자 중심 기능을 제공하는 Windows용 OpenXR 구현입니다. 애플리케이션의 관점에서 보면 시뮬레이터를 사용하는 것은 Windows에서 PCVR을 사용하는 것과 다르지 않습니다.
추가 참고 사항
위에서 언급했듯이 Pico 4와 같이 OpenXR을 사용하는 다른 장치도 작동할 수 있지만 Qt에서 검증되지 않았습니다. 테스트 대상 기기 목록은 향후 Qt 릴리스에서 변경되거나 늘어날 수 있습니다.
PCVR의 경우 고려해야 할 소프트웨어 스택 세부 사항과 복잡한 문제가 더 있습니다. 자세한 내용은 PCVR 전용 페이지를 참조하세요.
Qt Quick 3D Xr은 기본적으로 디버그 출력에 경고를 인쇄합니다. 진단 메시지는 기본적으로 인쇄되지 않습니다. 이를 활성화하려면 qt.quick3d.xr
로깅 카테고리를 활성화하세요. 예를 들어 환경 변수 QT_LOGGING_RULES=qt.quick3d.xr=true
를 설정하면 됩니다. 자세한 내용은 QLoggingCategory 을 참조하세요. 문제가 발생하거나 애플리케이션이 예상대로 시작되지 않을 때마다 추가 디버그 인쇄를 사용하도록 설정하는 것이 좋습니다. 문제를 보고할 때는 항상 오류 보고서에 전체 로그를 포함하세요. XR 애플리케이션을 실행하는 방법이 매우 다양하기 때문에, 특히 OpenXR이 관련된 경우 이러한 로그는 무슨 일이 일어나고 있는지 더 잘 이해하기 위해 필수적입니다.
메타 퀘스트 3 시작하기, Apple 비전 프로 시작하기 및 PCVR도참조하세요 .
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.