Descripción general del vídeo
Características de vídeo
Qt Multimedia Ofrece clases de C++ tanto de alto como de bajo nivel para reproducir y manipular datos de vídeo, así como tipos QML para la reproducción y la grabación. Algunas de las clases que se presentan aquí se solapan con las que se describen en la Descripción general de la cámara y la Descripción general del audio.
Detalles de la implementación de vídeo
Reproducción de vídeo en C++
Puedes utilizar la clase ` QMediaPlayer ` para decodificar un archivo de vídeo y mostrarlo mediante ` QVideoWidget`, ` QGraphicsVideoItem` o una clase personalizada.
A continuación se muestra un ejemplo de uso de ` QVideoWidget`:
player = new QMediaPlayer;
player->setSource(QUrl("http://example.com/myclip1.mp4"));
videoWidget = new QVideoWidget;
player->setVideoOutput(videoWidget);
videoWidget->show();
player->play();Y un ejemplo con ` QGraphicsVideoItem`:
player = new QMediaPlayer(this);
QGraphicsVideoItem *item = new QGraphicsVideoItem;
player->setVideoOutput(item);
graphicsView->scene()->addItem(item);
graphicsView->show();
player->setSource(QUrl("http://example.com/myclip4.ogv"));
player->play();Reproducción de vídeo en QML
Puedes utilizar VideoOutput para reproducir contenido proporcionado por un MediaPlayer o un Camera. El VideoOutput es un componente visual que se puede incrustar en un QQuickScene o un Window, mientras que toda la decodificación de medios y el control de reproducción se gestionan mediante el MediaPlayer o el CaptureSession. Se ha incluido un elemento Video para mayor comodidad. Este combina los elementos MediaPlayer, VideoOutput y AudioOutput en un solo elemento.
Trabajo con fotogramas de vídeo de bajo nivel
Qt Multimedia ofrece una serie de clases de bajo nivel para facilitar un poco el manejo de los fotogramas de vídeo. Estas clases se utilizan principalmente al escribir código que procesa fotogramas de vídeo o de cámara (por ejemplo, para detectar códigos de barras o aplicar un efecto de viñeta sofisticado), o que necesita mostrar vídeo de una forma especial que, de otro modo, no sería compatible.
La clase ` QVideoFrame ` encapsula un fotograma de vídeo y permite mapear su contenido en la memoria del sistema para su manipulación o procesamiento. El uso de tu propio ` QVideoSink ` te permite recibir estos fotogramas desde QMediaPlayer y QCamera.
Grabación de vídeo
La clase central para cualquier tipo de captura o grabación de audio y vídeo es ` QMediaCaptureSession ` (o el tipo QML ` CaptureSession `). Puedes conectar un ` QCamera ` (Cámara en QML) y un ` QMediaRecorder ` (`MediaRecorder`) a la sesión y, a continuación, solicitar al grabador multimedia que inicie la grabación.
Formatos multimedia compatibles
Los formatos multimedia compatibles dependen, en última instancia, de la configuración del sistema de destino.
Windows
Por defecto, las opciones disponibles en un sistema de destino con MS Windows dependen de la versión de Windows Media Player que se haya incluido con el sistema operativo. Consulta la documentación de Windows Media Player para obtener información oficial.
Independientemente de Windows Media Player, existen, por supuesto, numerosos paquetes de códecs que se pueden instalar. Consulte la página web de la guía de códecs para ver algunos ejemplos.
Android
Consulta los formatos multimedia compatibles con Android para obtener esta información.
Linux
En Linux, se trata de instalar los complementos correctos de GStreamer.
Complementos mínimos necesarios de GStreamer
- gstreamer1.0-plugins-base
- gstreamer1.0-plugins-good
- gstreamer1.0-plugins-pulseaudio
Para un entorno de escritorio Linux, se recomienda encarecidamente instalar gstreamer1.0-libav para disponer de una buena cobertura de códecs y gstreamer1.0-vaapi para obtener aceleración por hardware.
En Linux embebido, el conjunto de complementos necesarios podría ser algo diferente.
Determinación de los formatos multimedia compatibles en tiempo de ejecución
Se puede determinar qué formatos están disponibles en un sistema de destino en tiempo de ejecución utilizando la API estática QMediaFormat.
- Utiliza QMediaFormat::isSupported() en un QMediaFormat::ConversionMode para consultar un formato específico.
- Utilice QMediaFormat::supportedFileFormats() en un objeto QMediaFormat creado de forma predeterminada para obtener todos los formatos de archivo compatibles.
Ejemplos
Hay ejemplos disponibles tanto en C++ como en QML.
Ejemplos en C++
Muestra cómo capturar una imagen fija o grabar un vídeo. | |
Reproducción de audio y vídeo mediante Qt Widgets. |
Ejemplos de QML
Reproducción de audio y vídeo mediante Qt Quick | |
Reproducción de audio y vídeo mediante el tipo MediaPlayer de QML. | |
Grabación de audio y vídeo con « Qt Quick ». |
Documentación de referencia
Clases de C++
Abstracción para datos de vídeo | |
La estructura QAbstractVideoBuffer::MapData describe la disposición de los planos mapeados | |
Se utiliza para obtener la información básica de una ventana capturable | |
Fuente de vídeo respaldada por un elemento GStreamer personalizado | |
Permite la captura de contenido de audio y vídeo | |
Permite la reproducción de archivos multimedia | |
Se utiliza para codificar y grabar una sesión de captura | |
Permite un control de bajo nivel de las opciones de reproducción multimedia | |
Esta clase se utiliza para capturar la pantalla | |
Representa un fotograma de datos de vídeo | |
Especifica el formato de flujo de una superficie de presentación de vídeo | |
Se utiliza para proporcionar fotogramas de vídeo personalizados a QMediaRecorder o a una salida de vídeo a través de QMediaCaptureSession | |
Representa un receptor genérico para datos de vídeo | |
Widget que muestra el vídeo generado por un objeto multimedia | |
Esta clase se utiliza para capturar una ventana |
Tipos de QML
Este tipo se utiliza para obtener la información básica de una ventana que se puede capturar mediante WindowCapture | |
Permite capturar contenido de audio y vídeo | |
Una fuente de vídeo respaldada por un binario personalizado de GStreamer | |
Añade la reproducción de medios a una escena | |
Para codificar y grabar contenidos multimedia generados en una CaptureSession | |
Opciones de reproducción multimedia de bajo nivel | |
Este tipo se utiliza para capturar una pantalla | |
Un tipo práctico para mostrar un vídeo específico | |
Representar vídeo o el visor de la cámara | |
Este tipo se utiliza para capturar una ventana | |
Describe un dispositivo de cámara | |
Describe un formato de vídeo compatible con un dispositivo de cámara | |
Proporciona metadatos para archivos multimedia |
© 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.