Qt Multimedia
Qt Multimedia se presenta un módulo complementario que ofrece un amplio conjunto de tipos QML y clases C++ para gestionar contenidos multimedia. Contiene una API fácil de usar para reproducir archivos de audio y vídeo y mostrarlos en pantalla, así como una API completa para grabar audio y vídeo desde diversas fuentes, incluidas las cámaras y los micrófonos del sistema, capturas de pantalla o de ventanas, y búferes de memoria de audio o vídeo.
La funcionalidad de este módulo se divide en los siguientes submódulos:
| Qt Multimedia | Proporciona una API para casos de uso específicos de multimedia. |
| Qt Multimedia Widgets | Proporciona una API multimedia basada en widgets. |
| Qt Spatial Audio | Proporciona una API para implementar campos sonoros en el espacio 3D. |
Primeros pasos
Si estás realizando la migración de Qt 5 a Qt 6, consulta los cambios en Qt Multimedia.
Si eres nuevo en Qt Multimedia, los tipos QML se pueden importar a una aplicación utilizando la siguiente instrucción en tu archivo .qml.
import QtMultimediaPara vincular las bibliotecas de C++, añada lo siguiente al archivo ` CMakeLists.txt ` de su proyecto. Sustituya ` mytarget ` por el nombre de su proyecto.
find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)Consulte «Compilación de Qt Multimedia a partir del código fuente » para obtener orientación sobre cómo compilar Qt Multimedia a partir del código fuente.
Descripciones generales y temas importantes
- Cambios en Qt 6
- Descripción general de multimedia
- Descripción general del audio
- Descripción general del audio espacial
- Resumen de vídeo
- Descripción general de la cámara
- Formatos multimedia compatibles
Tipos QML
La siguiente tabla resume algunos tipos QML importantes.
| Tipo | Descripción |
|---|---|
| MediaPlayer | Añade funcionalidad de reproducción de audio y vídeo a una escena. |
| CaptureSession | Crea una sesión para la captura de audio y vídeo. |
| Camera | Accede a una cámara conectada al sistema. |
| AudioInput | Acceder a una entrada de audio (micrófono) conectada al sistema. |
| AudioOutput | Acceder a una salida de audio (altavoz, auriculares) conectada al sistema. |
| VideoOutput | Mostrar contenido de vídeo. |
| MediaRecorder | Graba audio y vídeo desde la cámara « CaptureSession ». |
| ImageCapture | Captura imágenes fijas desde la cámara. |
| Video | Añade la funcionalidad de reproducción de vídeo a una escena. Utiliza los tipos « MediaPlayer » y « VideoOutput » para proporcionar la funcionalidad de reproducción de vídeo. |
| ScreenCapture | Captura una pantalla. |
| WindowCapture | Captura una ventana de nivel superior. |
| GStreamerVideoSource | Fuente de vídeo GStreamer personalizada (con el backend multimedia de GStreamer). |
Clases de C++
La siguiente tabla resume algunas clases importantes de C++.
| Clase | Descripción |
|---|---|
| QMediaPlayer | Reproduce contenido multimedia desde una fuente. |
| QVideoWidget | Muestra vídeo desde un reproductor multimedia o una sesión de captura. |
| QMediaCaptureSession | Captura de audio y vídeo. |
| QCamera | Acceder a una cámara conectada al sistema |
| QAudioInput | Acceder a una entrada de audio (micrófono) conectada al sistema. |
| QAudioOutput | Acceder a una salida de audio (altavoz, auriculares) conectada al sistema. |
| QImageCapture | Capturar imágenes fijas con una cámara. |
| QMediaRecorder | Grabar contenido multimedia de una sesión de captura. |
| QVideoSink | Acceder a fotogramas de vídeo individuales y reproducirlos. |
| QAudioSink | Envía datos de audio sin procesar a un dispositivo de salida de audio. |
| QScreenCapture | Captura una pantalla. |
| QWindowCapture | Captura una ventana de nivel superior. |
| QVideoFrameInput | Se utiliza para mostrar o grabar fotogramas de vídeo desde búferes de memoria. |
| QAudioBufferInput | Admite la reproducción o grabación de audio desde búferes de memoria. |
| QGStreamerVideoSource | Fuente de vídeo personalizada de GStreamer (con el backend multimedia de GStreamer). |
Para la reproducción de audio y vídeo, QMediaPlayer, QAudioOutput y QVideoWidget contienen toda la funcionalidad necesaria. Otras clases se dedican a la captura de contenido de audio y vídeo, siendo QMediaCaptureSession la clase central que gestiona todo el proceso de captura y grabación.
Licencias y atribuciones
El módulo « Qt Multimedia » está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo licencias de software libre. Desde Qt 5.6, estas licencias de software libre son la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulte «Licencias de Qt» para obtener más detalles.
Por otra parte, « Qt Multimedia » en Qt 6.12.0 puede contener módulos de terceros bajo las siguientes licencias permisivas:
La Unlicense o la licencia MIT sin atribución | |
Licencia Pública General Reducida de GNU v2.1 o posterior, y Licencia BSD de 3 cláusulas «Nueva» o «Revisada», y Licencia BSD de 2 cláusulas «Simplificada», y Licencia de Atribución del Código Fuente de BSD, y Licencia ISC, y Licencia MIT, y Licencia Pública de Mozilla 2.0 | |
Licencia MIT | |
Licencia BSD de 3 cláusulas «Nueva» o «Revisada» | |
Licencia de software Boost 1.0 | |
Licencia del Grupo Independiente JPEG | |
Licencia zlib |
Ten en cuenta que los estándares de compresión de vídeo, como el estándar de compresión multimedia H.264, pueden estar protegidos por patentes y pueden conllevar el pago de derechos de autor. Esto puede aplicarse a cualquier implementación, incluso si esta se proporciona como un servicio del sistema operativo, a través de una biblioteca de terceros o de cualquiera de los backends de Qt Multimedia. Las licencias de Qt no cubren dichos derechos.
Notas sobre la plataforma de destino y los backends
Qt Multimedia ofrece API multiplataforma y fáciles de usar para la reproducción de medios, la grabación y la gestión de dispositivos. La implementación de las API principales, entre las que se incluyen QMediaDevices, QAudioDevice, QSoundEffect, QAudioSink y QAudioSource, está integrada en la biblioteca principal Qt Multimedia, lo que elimina la necesidad de bibliotecas adicionales. Otras API de Qt Multimedia se implementan mediante bibliotecas de complementos conocidas como backends multimedia. El backend multimedia principal, basado en FFmpeg, garantiza una funcionalidad multiplataforma sin problemas y es el predeterminado en todas las plataformas, excepto en WebAssembly y en Linux integrado/Boot2Qt. Con Boot2Qt, el backend predeterminado se basa en GStreamer, pero el backend multimedia de FFmpeg se puede habilitar mediante la variable de entorno QT_MEDIA_BACKEND.
El backend de FFmpeg
El backend multimedia de FFmpeg se basa en las bibliotecas de FFmpeg 9.0.1, que se incluyen en el paquete « Qt Online Installer » y han sido probadas por los mantenedores. Los paquetes binarios del instalador en línea utilizan enlaces dinámicos a FFmpeg. Por lo tanto, las aplicaciones deben incluir los binarios de FFmpeg en su instalador o depender de que FFmpeg esté instalado en el sistema operativo. Las bibliotecas de FFmpeg se implementan automáticamente mediante las herramientas de implementación de Qt, tal y como se describe en la documentación «Implementación de aplicaciones Qt», salvo en el caso de Linux/X11. Las aplicaciones también pueden implementar su propia compilación de FFmpeg, ya sea como bibliotecas compartidas o estáticas, siempre que la versión principal de FFmpeg coincida con la utilizada por Qt.
Aunque Qt Multimedia aprovecha el backend multimedia de FFmpeg en la mayoría de los sistemas operativos, pueden surgir diferencias funcionales o visuales específicas de cada plataforma entre aplicaciones en distintas plataformas. FFmpeg no ofrece compatibilidad idéntica con códecs y formatos en todas las plataformas, y el rendimiento de las funciones de Qt Multimedia puede depender de la compatibilidad con el hardware, que solo está disponible en determinadas plataformas. Por ejemplo, FFmpeg presenta problemas específicos con la aceleración por hardware en sistemas Linux con arquitecturas ARM. Por lo tanto, se recomienda probar las aplicaciones de Qt Multimedia en todas las plataformas de destino.
Nota: El proyecto FFmpeg ofrece funciones bajo diversas licencias. Las bibliotecas FFmpeg precompiladas que se proporcionan a través del instalador en línea solo incluyen funciones que se ajustan a las licencias permisivas enumeradas en «Licencias y atribuciones».
Para facilitar el desarrollo y la depuración, algunas funcionalidades de FFmpeg se pueden configurar mediante variables de entorno que forman parte de la API privada Qt Multimedia.
Backends nativos
Para garantizar la compatibilidad con las aplicaciones existentes, mantenemos backends multimedia nativos para cada sistema operativo:
- Backend GStreamer en Linux embebido
- AVFoundation en macOS e iOS
- Windows Media Foundation en Windows (obsoleto desde Qt 6.10)
- Marco MediaCodec en Android
- WebAudio y WebVideo en WebAssembly
Nota: El backend multimedia FFmpeg es el predeterminado, excepto en WebAssembly, donde los backends nativos siguen estando disponibles, aunque con compatibilidad limitada. El backend GStreamer solo está disponible en Linux y se recomienda únicamente para aplicaciones integradas.
Nota: MediaCodec en Android ha quedado obsoleto a partir de Qt 6.8 y se eliminará en la próxima versión principal.
Nota: El backend multimedia de Windows, basado en Windows Media Foundation, está en desuso a partir de Qt 6.10 y se eliminará en la próxima versión principal.
Los mantenedores de Qt se esforzarán por solucionar los problemas críticos de los backends nativos, pero no garantizan la corrección de problemas menores, incluido el comportamiento inconsistente entre plataformas. Las nuevas funciones solo se implementarán en el backend multimedia FFmpeg, con la excepción de WebAssembly.
El backend de GStreamer cuenta con algunas API privadas que permiten un control más preciso. Sin embargo, existen errores conocidos en el backend de GStreamer. Se puede encontrar más información en las notas de la plataforma para el backend de GStreamer.
Las limitaciones de los backends se documentarán y su estado se mantendrá en las clases correspondientes.
Cambio de backends
En caso de que surjan problemas con el backend predeterminado de FFmpeg, recomendamos probar con un backend nativo. Puedes cambiar a backends nativos configurando la variable de entorno « QT_MEDIA_BACKEND » en « windows », « gstreamer » (en Linux embebido), « darwin » (en macOS e iOS) o « android »:
export QT_MEDIA_BACKEND=darwinPara forzar la asignación de FFmpeg como backend utilizado, establece la variable en ffmpeg:
export QT_MEDIA_BACKEND=ffmpegEn la fase de compilación de Qt Multimedia, el backend multimedia predeterminado se puede configurar mediante la variable de CMake QT_DEFAULT_MEDIA_BACKEND.
Notas sobre las plataformas de destino
Las siguientes páginas enumeran los problemas relacionados con plataformas de destino específicas.
Permisos
A partir de Qt 6.6, el módulo Qt Multimedia utiliza la nueva API QPermission para gestionar los permisos camera y microphone. Esto significa que Qt ya no solicita estos permisos por sí mismo, por lo que debe hacerse directamente desde la aplicación cliente.
Consulte la página Permisos de la aplicación para ver un ejemplo de cómo integrar la nueva API de QPermission en la aplicación.
Referencia y ejemplos
© 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.