이 페이지에서

Qt Multimedia Linux에서

이 페이지에서는 리눅스에서 Qt Multimedia 을 사용할 때 고려해야 할 사항에 대해 설명합니다.

오디오 백엔드 요구 사항

Qt Multimedia Linux에서 오디오 기능을 사용하려면 PipeWire 또는 PulseAudio가 필요합니다. PipeWire는 모든 최신 Linux 배포판에서 권장되는 백엔드이지만, PipeWire를 사용할 수 없는 경우 PulseAudio가 사용됩니다. 실험적인 ALSA 백엔드는 향후 Qt 버전에서 더 이상 지원되지 않을 예정입니다. 그때까지 이 백엔드의 문제를 해결하려면 커뮤니티의 기여가 필요합니다.

임베디드 리눅스에서 GStreamer 백엔드를 사용하는 애플리케이션의 경우, 추가적인 PulseAudio 요구 사항에 대해서는 Qt Multimedia GStreamer 백엔드 문서를 참조하십시오.

Wayland 컴포지터를 사용하는 리눅스의 제한 사항

화면 캡처 기능을 사용하려면 다음을 설치해야 합니다:

Wayland 프로토콜의 제한 사항으로 인해, QScreenCapture 인스턴스가 활성화될 때 운영 체제에서 표시하는 마법사를 통해서만 현재 화면을 선택할 수 있습니다. 자세한 내용은 QScreenCapture 클래스 문서를 참조하십시오.

하드웨어 인코딩/디코딩 드라이버

Linux에서 하드웨어 가속 비디오 인코딩 및 디코딩을 사용하려면 플랫폼별 드라이버가 필요합니다. 필요한 드라이버가 없는 경우 Qt Multimedia 는 소프트웨어 인코딩/디코딩으로 대체될 수 있지만, 하드웨어 지원 드라이버를 설치하면 성능이 크게 향상되고 CPU 사용량이 감소할 수 있습니다.

사용 중인 하드웨어에 적합한 드라이버 패키지를 설치하십시오:

  • intel-media-va-driver — Intel Gen 8+ (Broadwell 2014+), Arc A-시리즈 및 그 이후 프로세서
  • intel-media-va-driver-non-free — 추가 독점 코덱이 포함된 인텔 미디어 드라이버
  • i965-va-driver — 구형 인텔 하드웨어(샌디 브릿지, 아이비 브릿지, 하스웰)
  • mesa-va-drivers — AMD GPU용 VA-API 지원
  • nvidia-driver — NVIDIA 전용 그래픽 드라이버(예: nvidia-driver-525 이상)

© 2026 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.