소스 코드로부터 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을 지원하는 Qt Multimedia 을 빌드하려면, Qt를 빌드할 때 configure 명령줄에서 ` -ffmpeg-dir ` 옵션을 지정하십시오.

qt-source/configure -ffmpeg-dir <FFMPEG_DIR>

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

네이티브 미디어 백엔드 없이 Qt Multimedia 를 빌드하려면, -no-feature-xxx 를 사용하여 gstreamer, native_windows_backend, native_darwin_backend 또는 native_android_backend 와 같은 해당 기능을 제외하십시오.

qt-source/configure -no-feature-gstreamer

Qt의 모든 하위 모듈을 빌드하지 않으려는 경우, ` -submodules ` 구성 옵션을 사용하여 구성 및 빌드 시간을 단축할 수 있습니다. 이렇게 하면 ` Qt Multimedia ` 및 그 종속성만 빌드하도록 구성됩니다.

qt-source/configure -submodules qtmultimedia -ffmpeg-dir <FFMPEG_DIR>

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

path 에 이러한 라이브러리가 아직 없는 경우, ` -ffmpeg-deploy ` 구성 옵션을 지정하십시오. 이 옵션을 활성화하면 빌드 및 설치 단계에서 필요한 FFmpeg 바이너리가 Qt의 설치 디렉터리로 복사됩니다:

qt-source/configure -submodules qtmultimedia -ffmpeg-dir <FFMPEG_DIR> -ffmpeg-deploy

Qt Multimedia 을 구성한 후, 구성 요약(config.summary 파일에 있음)을 주의 깊게 검토하십시오. "Plugin" 섹션에서 FFmpeg이 인식되었는지 확인할 수 있습니다. 그런 다음 Qt 소스 빌드 방법에 설명된 일반적인 빌드 및 설치 단계를 따르십시오.

플랫폼 관련 참고 사항

iOS

• Qt Multimedia 를 FFmpeg 지원으로 구성할 때, CMake 구성 프로세스는 제공된 FFmpeg 디렉터리에서 .xcframework 파일을 찾습니다. .dylib 바이너리를 직접 사용하는 것은 지원되지 않습니다. FFmpeg 빌드 결과물을 .xcframework 파일에 패키징하는 방법에 대한 자세한 내용은 macOS에서 iOS용 FFmpeg 소스 빌드(Building FFmpeg from source for iOS on macOS ) 및 FFmpeg 빌드 결과물을 파일에 패키징하기( https://developer.apple.com/documentation/xcode/creating-a-multi-platform-binary-framework-bundle )를 참조하십시오.

Linux

• Qt Multimedia 를 FFmpeg이 활성화된 상태로 구성할 때는 pipewire 또는 pulseaudio 개발 패키지가 필요합니다. 이 패키지 중 하나가 없으면 FFmpeg이 인식되지 않습니다.
• VAAPI를 지원하는 버전으로 빌드된 FFmpeg을 사용하는 경우, 하드웨어 텍스처 변환이 가능하도록 Qt Multimedia 도 VAAPI를 지원하도록 빌드하는 것이 좋습니다. Qt Multimedia 를 VAAPI 지원으로 구성하려면 시스템에 VAAPI 개발자 라이브러리가 설치되어 있어야 합니다. config.summary 파일을 검토하여 "하드웨어 가속 및 기능(Hardware acceleration and features)" 섹션에서 VAAPI 지원이 활성화되어 있는지 확인하십시오.
• GStreamer 백엔드를 사용하여 Qt Multimedia 를 구성할 경우, GStreamer v1.20 이상이 필수입니다. 다만 가능하면 최신 안정판 GStreamer 업스트림 릴리스를 사용하는 것이 좋습니다.