En esta página

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.

Ejemplos

Hay ejemplos disponibles tanto en C++ como en QML.

Ejemplos en C++

Camera Example

Muestra cómo capturar una imagen fija o grabar un vídeo.

Media Player Example

Reproducción de audio y vídeo mediante Qt Widgets.

Ejemplos de QML

Media Player

Reproducción de audio y vídeo mediante Qt Quick

QML Media Player Example

Reproducción de audio y vídeo mediante el tipo MediaPlayer de QML.

QML Video Recorder

Grabación de audio y vídeo con « Qt Quick ».

Documentación de referencia

Clases de C++

QAbstractVideoBuffer

Abstracción para datos de vídeo

QAbstractVideoBuffer::MapData

La estructura QAbstractVideoBuffer::MapData describe la disposición de los planos mapeados

QCapturableWindow

Se utiliza para obtener la información básica de una ventana capturable

QGStreamerVideoSource

Fuente de vídeo respaldada por un elemento GStreamer personalizado

QMediaCaptureSession

Permite la captura de contenido de audio y vídeo

QMediaPlayer

Permite la reproducción de archivos multimedia

QMediaRecorder

Se utiliza para codificar y grabar una sesión de captura

QPlaybackOptions

Permite un control de bajo nivel de las opciones de reproducción multimedia

QScreenCapture

Esta clase se utiliza para capturar la pantalla

QVideoFrame

Representa un fotograma de datos de vídeo

QVideoFrameFormat

Especifica el formato de flujo de una superficie de presentación de vídeo

QVideoFrameInput

Se utiliza para proporcionar fotogramas de vídeo personalizados a QMediaRecorder o a una salida de vídeo a través de QMediaCaptureSession

QVideoSink

Representa un receptor genérico para datos de vídeo

QVideoWidget

Widget que muestra el vídeo generado por un objeto multimedia

QWindowCapture

Esta clase se utiliza para capturar una ventana

Tipos de QML

CapturableWindow

Este tipo se utiliza para obtener la información básica de una ventana que se puede capturar mediante WindowCapture

CaptureSession

Permite capturar contenido de audio y vídeo

GStreamerVideoSource

Una fuente de vídeo respaldada por un binario personalizado de GStreamer

MediaPlayer

Añade la reproducción de medios a una escena

MediaRecorder

Para codificar y grabar contenidos multimedia generados en una CaptureSession

PlaybackOptions

Opciones de reproducción multimedia de bajo nivel

ScreenCapture

Este tipo se utiliza para capturar una pantalla

Video

Un tipo práctico para mostrar un vídeo específico

VideoOutput

Representar vídeo o el visor de la cámara

WindowCapture

Este tipo se utiliza para capturar una ventana

cameraDevice

Describe un dispositivo de cámara

cameraFormat

Describe un formato de vídeo compatible con un dispositivo de cámara

mediaMetaData

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.