Cambios en Qt Multimedia
Qt 6 son el resultado de un esfuerzo deliberado por hacer que el marco de trabajo sea más eficiente y fácil de usar.
Intentamos mantener la compatibilidad binaria y de código fuente para todas las API públicas en cada versión. Sin embargo, algunos cambios eran inevitables para hacer de Qt un marco de trabajo mejor.
El módulo se ha refactorizado de forma significativa y ha cambiado de clasificación, pasando de «esencial» a «complemento». El módulo Qt Multimedia de Qt 6 sustituye al módulo Qt Multimedia de Qt 5.x. El código existente que utiliza Qt Multimedia de Qt 5 se puede portar con un esfuerzo mínimo.
Nuevas características de Qt 6
Qt Multimedia incluye varias características nuevas:
- QMediaCaptureSession La clase es el objeto central para la captura de medios.
- QMediaRecorder La clase `class` es ahora una clase limitada a la grabación de audio y vídeo. Se encarga de la codificación de los datos generados en una sesión de captura.
- Al utilizar ` QMediaFormat ` y ` QMediaRecorder`, la configuración de la codificación deseada durante la grabación ha cambiado significativamente.
- Ahora también se puede supervisar el audio grabado durante una sesión de captura.
- Se ha añadido la compatibilidad con la selección de pistas de audio, vídeo y subtítulos al reproducir archivos multimedia.
- QAudioDecoder Ahora es compatible con todas las plataformas.
Funciones eliminadas
| Funcionalidad eliminada | Notas o alternativa sugerida |
|---|---|
| La lista de reproducción en QMediaPlayer | QMediaPlayer ya no gestiona listas de reproducción en Qt 6. |
| QMediaPlayList | Esta clase se ha eliminado de la API. Sin embargo, sigue existiendo como parte del ejemplo del reproductor multimedia. |
| QAudioProbe y QVideoProbe | Se ha eliminado la API de detección de audio y vídeo. |
| QAudioRecorder | Utiliza el tipo QML « QMediaCaptureSession » o « CaptureSession ». |
| Tipo QML de audio | Utilice el tipo QML « MediaPlayer ». |
| QMediaObject y QMediaBindableInterface | Estas clases se han eliminado en favor de una API más directa para establecer conexiones entre objetos utilizando, por ejemplo, setVideoOutput y QMediaCaptureSession. |
| QCameraViewFinderSettings | Esta clase se ha eliminado. Utiliza ` QCameraFormat ` para definir la resolución y la frecuencia de fotogramas que debe utilizar la cámara. |
| QMediaContent | Esta clase se ha eliminado. En su lugar, utiliza ` QUrl ` para archivos multimedia individuales. |
| QSound | Utilice en su lugar QSoundEffect. |
| QVideoFilterRunnable | Utiliza efectos de sombreado en QML o accede al contenido de QVideoFrame en C++. |
| API de back-end pública | La API de back-end de Qt Multimedia es privada en Qt 6. Esto mejora el tiempo de respuesta para dar soporte a nuevos casos de uso multimedia. Cualquier clase que contenga las palabras «Control» o «Abstract» en el nombre de la clase en Qt 5 es ahora privada en Qt 6. |
| La compatibilidad con el audio ALSA en Linux es experimental | El audio en Linux requiere PulseAudio. La compatibilidad experimental con ALSA quedará obsoleta en futuras versiones de Qt. Consulta las notas sobre la plataforma Linux para obtener más detalles. |
Características modificadas
Varias clases que antes se ofrecían en Qt Multimedia han sufrido cambios que pueden afectar al código escrito anteriormente. La siguiente tabla destaca estos cambios.
| Característica modificada | Notas |
|---|---|
| Gestión de las resoluciones y frecuencias de fotogramas de la cámara | Se ha simplificado su gestión y una nueva clase de QCameraFormat ayuda a seleccionar la resolución y la frecuencia de fotogramas correctas para la cámara. |
| El manejo de la salida de vídeo en C++ ha cambiado significativamente. | QAbstractVideoSurface ha sido sustituida por la clase QVideoSink, y se ha mejorado la compatibilidad con el renderizado genérico para abarcar todos los formatos de píxelescompatibles con Qt Multimedia. |
| Los tipos de metadatos | QMediaMetaData ha cambiado significativamente: principalmente, se ha pasado de claves basadas en cadenas a claves basadas en enumeraciones, y se ha reducido el conjunto de claves admitidas a aquellas que son compatibles con la mayoría de las plataformas. |
| QMediaFormat | El manejo de los formatos para los medios codificados y la configuración del grabador multimedia han cambiado significativamente. Qt 5 proporciona una API basada en cadenas, un formato de archivo independiente y códecs de audio y vídeo distribuidos en tres clases. Sin embargo, Qt 6 unifica los formatos en la clase ` QMediaFormat `. Los ajustes adicionales se especifican directamente en QMediaRecorder. La configuración de formatos de archivo y códecs se implementa ahora mediante enumeraciones y ya no utiliza cadenas de caracteres. Esto impone algunas limitaciones al conjunto de códecs que se pueden utilizar, pero contribuye a proporcionar una API multiplataforma coherente. |
| Cambio de nombre de QCameraImageCapture QImageCapture | Ninguna |
| Entradas y salidas de audio | QMediaPlayer y QMediaCaptureSession (así como los tipos QML correspondientes MediaPlayer y CaptureSession) no están conectados a ningún dispositivo de audio de forma predeterminada. Conéctalos explícitamente a un QAudioInput/AudioInput o QAudioOutput/AudioOutput para capturar o reproducir audio. |
| Captura de vídeo | Por defecto, una sesión de captura no está conectada a una cámara. Conéctala a un objeto QCamera (elemento «Cámara») para poder capturar vídeo o imágenes fijas. |
© 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.