소스에서 Qt Multimedia 구축하기

이 페이지는 구성 및 빌드 프로세스에 대해 설명합니다. Qt Multimedia. 이 설명은 플랫폼에 대한 빌드 요구 사항을 지정하는 Qt 소스 빌드 및 Qt 구성 옵션에 대한 개요에 익숙하다고 가정합니다. Qt Multimedia 모듈과 관련된 플랫폼별 고려 사항은 아래의 플랫폼 노트를 참조하십시오.

소스에서 빌드하기

전체 기능을 지원하는 Qt Multimedia 빌드는 대부분의 플랫폼에서 FFmpeg 헤더와 라이브러리에 따라 달라집니다. Qt Multimedia FFmpeg 미디어 백엔드 없이 Qt Multimedia 을 빌드할 수 있지만, 이는 FFmpeg 백엔드가 지원되지 않는 플랫폼용으로 빌드할 때만 권장됩니다.

Qt Multimedia 빌드에 필요한 FFmpeg 개발 라이브러리는 소스에서 빌드하거나 바이너리 패키지로 다운로드할 수 있습니다. Qt Multimedia 정적 링크 또는 동적 링크 중 하나를 사용하여 FFmpeg 라이브러리를 빌드할 수 있습니다. FFmpeg에 기본 백엔드로 나열된 것과 동일한 주요 버전의 FFmpeg를 사용하는 것이 좋습니다. FFmpeg 개발 라이브러리를 빌드하는 방법에 대한 자세한 내용은 소스에서 FFmpeg 빌드하기를 참조하세요.

FFmpeg를 지원하는 Qt Multimedia 을 빌드하려면, Qt를 빌드할 때 configure 명령줄에 -DFFMPEG_DIR CMake 변수를 지정합니다. 일반 구성 인자와 CMake 매개 변수를 구분하는 -- 구분 기호에 유의하세요.

qt-source/configure -- -DFFMPEG_DIR=<FFMPEG_DIR>

여기서 <FFMPEG_DIR> 은 FFmpeg include, lib, bin 디렉터리가 포함된 디렉토리입니다. FFmpeg 없이 Qt Multimedia 빌드하려면 <FFMPEG_DIR> 변수를 생략하고 -no-feature-ffmpeg configure 옵션을 지정합니다.

Qt의 모든 서브모듈을 빌드하지 않으려면 -submodules configure 옵션을 사용하여 구성 및 빌드 시간을 줄일 수 있습니다. 이렇게 하면 Qt Multimedia 및 해당 종속성만 빌드하는 빌드가 구성됩니다.

qt-source/configure -submodules qtmultimedia -- -DFFMPEG_DIR=<FFMPEG_DIR>

공유 라이브러리로 빌드된 FFmpeg에 대해 Qt Multimedia 을 구성하는 경우(동적 링크), 테스트를 실행하거나 예제를 사용하려면 모듈 로더의 검색 경로에 FFmpeg 공유 라이브러리가 있어야 합니다.

path 에 아직 이러한 라이브러리가 없는 경우 -DQT_DEPLOY_FFMPEG=ON 구성 옵션을 지정하세요. 이 옵션을 활성화하면 빌드 및 설치 단계 중에 필요한 FFmpeg 바이너리가 Qt의 설치 디렉터리에 복사됩니다:

qt-source/configure -submodules qtmultimedia -- -DFFMPEG_DIR=<FFMPEG_DIR> -DQT_DEPLOY_FFMPEG=ON

Qt Multimedia 을 구성한 후 config.summary 파일에 있는 구성 요약을 주의 깊게 검토합니다. "플러그인" 섹션에서 FFmpeg가 있는지 확인할 수 있습니다. 그런 다음 Qt 소스 빌드하기에서 설명한 일반 빌드 및 설치 단계를 따르세요.

플랫폼 참고 사항

Linux

• FFmpeg를 활성화하여 Qt Multimedia 을 구성할 때는 pulseaudio 개발 패키지가 필요합니다. 이 패키지가 없으면 FFmpeg가 인식되지 않습니다.
• VAAPI 지원으로 빌드된 FFmpeg 버전을 사용하는 경우 하드웨어 텍스처 변환을 가능하게 하려면 Qt Multimedia 도 VAAPI 지원으로 빌드하는 것이 좋습니다. VAAPI 지원으로 Qt Multimedia 을 구성하려면 시스템에 VAAPI 개발자 라이브러리가 설치되어 있어야 합니다. config.summary 파일을 검토하여 '하드웨어 가속 및 기능' 섹션에서 VAAPI 지원이 활성화되어 있는지 확인합니다.
• GStreamer 백엔드로 Qt Multimedia 을 구성할 때 최소 요구 사항은 GStreamer v1.20입니다. 그러나 가능하면 안정적인 최신 GStreamer 업스트림 릴리스를 사용하는 것이 좋습니다.