En esta página

Compilación de « Qt Multimedia » a partir del código fuente

Esta página describe el proceso de configuración y compilación Qt Multimedia. Esta descripción da por hecho que el lector está familiarizado con la sección «Compilación de Qt a partir del código fuente», que especifica los requisitos de compilación para su plataforma, así como con la descripción general de las «Opciones de configuración de Qt». Para conocer las consideraciones específicas de cada plataforma relacionadas con el módulo « Qt Multimedia », consulte las «Notas sobre plataformas » que figuran a continuación.

Compilación a partir del código fuente

La compilación de Qt Multimedia con todas las funciones disponibles depende de los encabezados y las bibliotecas de FFmpeg en la mayoría de las plataformas. Es posible compilar Qt Multimedia sin el backend multimedia de FFmpeg Qt Multimedia, pero esto solo se recomienda al compilar para plataformas en las que no se admite el backend de FFmpeg.

Las bibliotecas de desarrollo de FFmpeg necesarias para compilar Qt Multimedia pueden compilarse a partir del código fuente o descargarse como paquetes binarios. Qt Multimedia puede utilizar tanto enlaces estáticos como dinámicos a las bibliotecas de FFmpeg. Recomendamos utilizar la misma versión principal de FFmpeg que se indica en las notas sobre plataformas de destino y backends. Para obtener información sobre cómo compilar las bibliotecas de desarrollo de FFmpeg, consulta «Compilación de FFmpeg a partir del código fuente».

Nota: La versión mínima de FFmpeg compatible con el backend de FFmpeg de Qt Multimedia es la 4.4.

Para compilar Qt Multimedia con soporte para FFmpeg, especifica la opción « -ffmpeg-dir » en la línea de comandos de «configure» al compilar Qt.

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

En este caso, « <FFMPEG_DIR> » es el directorio que contiene los directorios «include», «lib» y «bin» de FFmpeg. Para compilar « Qt Multimedia » sin FFmpeg, omite la variable « <FFMPEG_DIR> » y especifica la opción de configuración « -no-feature-ffmpeg ».

Para compilar Qt Multimedia sin backends multimedia nativos, utiliza -no-feature-xxx para excluir las características correspondientes, como gstreamer, native_windows_backend, native_darwin_backend o native_android_backend.

qt-source/configure -no-feature-gstreamer

Si prefieres no compilar todos los submódulos de Qt, puedes reducir los tiempos de configuración y compilación utilizando la opción de configuración -submodules. Esto configurará una compilación que solo compile Qt Multimedia y sus dependencias.

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

Si configura Qt Multimedia con FFmpeg compilado con bibliotecas compartidas (enlaces dinámicos), las bibliotecas compartidas de FFmpeg deben estar en la ruta de búsqueda del cargador de módulos para poder ejecutar pruebas o utilizar ejemplos.

Nota: Qt Multimedia requiere las bibliotecas avformat, avcodec, swresample, swscale y avutil de FFmpeg durante el tiempo de ejecución para poder utilizar el backend multimedia de FFmpeg. Si no se encuentra una o varias de estas bibliotecas dinámicas durante el inicio de la aplicación, el backend multimedia de FFmpeg no se cargará y el sistema intentará cargar el backend nativo. Qt Multimedia no admite tantas funciones en los backends nativos.

Si aún no dispone de estas bibliotecas en « path », especifique la opción de configuración « -ffmpeg-deploy ». Con esta opción activada, los binarios necesarios de FFmpeg se copiarán al directorio de instalación de Qt durante los pasos de compilación e instalación:

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

Tras configurar Qt Multimedia, revisa detenidamente el resumen de la configuración (que se encuentra en el archivo config.summary). Puedes comprobar que FFmpeg aparece en la sección «Plugin». A continuación, sigue los pasos habituales de compilación e instalación descritos en «Compilación de fuentes de Qt».

Nota: Al compilar Qt Multimedia de forma estática, la ruta a las bibliotecas de FFmpeg queda integrada en libQt6FFmpegMediaPluginImpl.prl. Tendrás que modificar la ruta si tu Qt se va a utilizar en otro equipo.

Notas sobre la plataforma

iOS

Linux

  • Al configurar Qt Multimedia con FFmpeg habilitado, se requiere el paquete de desarrollo de Pipewire o Pulseaudio. Sin uno de estos paquetes, FFmpeg no será reconocido.
  • Si se utiliza una versión de FFmpeg compilada con soporte para VAAPI, recomendamos compilar también Qt Multimedia con soporte para VAAPI para permitir la conversión de texturas por hardware. Para configurar Qt Multimedia con soporte para VAAPI, deben estar instaladas en el sistema las bibliotecas de desarrollo de VAAPI. Revisa el archivo config.summary para comprobar que el soporte VAAPI está habilitado en la sección «Aceleración por hardware y características».
  • Al configurar Qt Multimedia con el backend de GStreamer, se requiere como mínimo GStreamer v1.20. No obstante, recomendamos utilizar la última versión estable de GStreamer del proyecto original, si es posible.

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