En esta página

QVideoFrameInput Class

La clase `QVideoFrameInput` se utiliza para proporcionar fotogramas de vídeo personalizados a ` QMediaRecorder ` o a una salida de vídeo a través de ` QMediaCaptureSession`. Más información...

Encabezado: #include <QVideoFrameInput>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
Desde: Qt 6.8
Heredado de: QObject

Funciones públicas

QVideoFrameInput(QObject *parent = nullptr)
QVideoFrameInput(const QVideoFrameFormat &format, QObject *parent = nullptr)
virtual ~QVideoFrameInput() override
QMediaCaptureSession *captureSession() const
QVideoFrameFormat format() const
bool sendVideoFrame(const QVideoFrame &frame)

Señales

Descripción detallada

QVideoFrameInput solo es compatible con el backend de FFmpeg.

Se pueden grabar fotogramas de vídeo personalizados conectando un ` QVideoFrameInput ` y un ` QMediaRecorder ` a un ` QMediaCaptureSession`. Para una implementación en modo «pull», llama a ` sendVideoFrame()` en respuesta a la señal ` readyToSendVideoFrame()`. En el fragmento de código que aparece a continuación, esto se hace conectando la señal a una ranura en una clase generadora de medios personalizada. La función de la ranura emite otra señal con un nuevo fotograma de vídeo, que se conecta a ` sendVideoFrame()`:

QMediaCaptureSession session;
QMediaRecorder recorder;
QVideoFrameInput videoInput;

session.setRecorder(&recorder);
session.setVideoFrameInput(&videoInput);

MediaGenerator generator; // Custom class providing video frames

connect(&videoInput, &QVideoFrameInput::readyToSendVideoFrame,
        &generator, &MediaGenerator::nextVideoFrame);
connect(&generator, &MediaGenerator::videoFrameReady,
        &videoInput, &QVideoFrameInput::sendVideoFrame);

recorder.record();

A continuación se muestra una implementación mínima de la función de ranura que proporciona fotogramas de vídeo:

void MediaGenerator::nextVideoFrame()
{
    QVideoFrame frame = nextFrame();
    emit videoFrameReady(frame);
}

Para más detalles, consulta readyToSendVideoFrame() y sendVideoFrame().

Véase también QMediaRecorder, QMediaCaptureSession y QVideoSink.

Documentación de funciones de miembro

[explicit] QVideoFrameInput::QVideoFrameInput(QObject *parent = nullptr)

Crea un nuevo objeto `QVideoFrameInput` con ` parent`.

[explicit] QVideoFrameInput::QVideoFrameInput(const QVideoFrameFormat &format, QObject *parent = nullptr)

Crea un nuevo objeto `QVideoFrameInput` con el fotograma de vídeo ` format ` y ` parent`.

El format especificado servirá de referencia para la inicialización del codificador de vídeo correspondiente al invocar QMediaRecorder::record(). Si no se especifica el formato o este no es válido, el codificador de vídeo se inicializará al enviar el primer fotograma. El envío de fotogramas de vídeo con otro formato y tamaño de píxeles tras la inicialización del codificador de vídeo correspondiente podría provocar una pérdida de rendimiento durante la grabación.

Recomendamos especificar el formato si se sabe de antemano qué tipo de fotogramas se van a enviar.

[override virtual noexcept] QVideoFrameInput::~QVideoFrameInput()

Destruye el objeto.

QMediaCaptureSession *QVideoFrameInput::captureSession() const

Devuelve la sesión de captura a la que está conectada esta entrada de fotograma de vídeo, o un objeto ` nullptr ` si la entrada de fotograma de vídeo no está conectada a ninguna sesión de captura.

Utiliza QMediaCaptureSession::setVideoFrameInput() para conectar la entrada de fotograma de vídeo a una sesión.

QVideoFrameFormat QVideoFrameInput::format() const

Devuelve el formato del fotograma de vídeo que se especificó al crear el fotograma de vídeo de entrada.

[signal] void QVideoFrameInput::readyToSendVideoFrame()

Indica que se puede enviar un nuevo fotograma a la entrada de fotogramas de vídeo. Tras recibir la señal, si tienes fotogramas que enviar, llama a ` sendVideoFrame ` una vez o en un bucle hasta que devuelva ` false`.

Véase también sendVideoFrame().

bool QVideoFrameInput::sendVideoFrame(const QVideoFrame &frame)

Envía « QVideoFrame » a « QMediaRecorder » o una salida de vídeo a través de « QMediaCaptureSession ».

Devuelve true si el frame especificado se ha enviado correctamente al destino. Devuelve false si el fotograma no se ha enviado, lo cual puede ocurrir si la instancia no está asignada a QMediaCaptureSession, la sesión no tiene salidas de vídeo ni un grabador multimedia, el grabador multimedia no está iniciado o su cola está llena. Se enviará la señal readyToSendVideoFrame tan pronto como el destino pueda gestionar un nuevo fotograma.

QMediaRecorder interpreta el envío de un fotograma de vídeo vacío como el final del flujo de entrada. QMediaRecorder detiene la grabación automáticamente si QMediaRecorder::autoStop es true y todas las entradas han notificado el final del flujo.

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