En esta página

QMediaCaptureSession Class

La clase QMediaCaptureSession permite capturar contenido de audio y vídeo. Más información...

Encabezado: #include <QMediaCaptureSession>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
En QML: CaptureSession
Heredan de: QObject

Propiedades

Funciones públicas

QMediaCaptureSession(QObject *parent = nullptr)
virtual ~QMediaCaptureSession() override
QAudioBufferInput *audioBufferInput() const
QAudioInput *audioInput() const
QAudioOutput *audioOutput() const
QCamera *camera() const
QImageCapture *imageCapture()
QObject *nativeVideoSource() const
QMediaRecorder *recorder()
QScreenCapture *screenCapture()
void setAudioBufferInput(QAudioBufferInput *input)
void setAudioInput(QAudioInput *input)
void setAudioOutput(QAudioOutput *output)
void setCamera(QCamera *camera)
void setImageCapture(QImageCapture *imageCapture)
void setNativeVideoSource(QObject *videoSource)
void setRecorder(QMediaRecorder *recorder)
void setScreenCapture(QScreenCapture *screenCapture)
void setVideoFrameInput(QVideoFrameInput *input)
void setVideoOutput(QObject *output)
void setVideoSink(QVideoSink *sink)
void setWindowCapture(QWindowCapture *windowCapture)
QVideoFrameInput *videoFrameInput() const
QObject *videoOutput() const
QVideoSink *videoSink() const
QWindowCapture *windowCapture()

Señales

Descripción detallada

QMediaCaptureSession es la clase central que gestiona la captura de contenido multimedia en el dispositivo local.

Puedes conectar una entrada de vídeo a `QMediaCaptureSession` utilizando ` setCamera()`, ` setScreenCapture()`, ` setWindowCapture()` o ` setVideoFrameInput()`. Se puede ver una vista previa del contenido multimedia capturado configurando ` QVideoWidget ` o ` QGraphicsVideoItem ` mediante ` setVideoOutput()`.

Puedes conectar un micrófono a QMediaCaptureSession mediante setAudioInput(), o configurar tu entrada de audio personalizada mediante setAudioBufferInput(). El sonido capturado se puede escuchar desviando el audio a un dispositivo de salida mediante setAudioOutput().

Puedes capturar imágenes fijas desde una cámara configurando un objeto ` QImageCapture ` en la sesión de captura, y grabar audio/vídeo utilizando un ` QMediaRecorder`.

Véase también QCamera, QAudioDevice, QMediaRecorder, QImageCapture, QScreenCapture, QWindowCapture, QVideoFrameInput, QGStreamerVideoSource y QGraphicsVideoItem.

Documentación de la propiedad

[since 6.8] audioBufferInput : QAudioBufferInput*

Esta propiedad contiene el objeto que se utiliza para enviar búferes de audio personalizados a QMediaRecorder.

Esta enumeración se introdujo en Qt 6.8.

Funciones de acceso:

QAudioBufferInput *audioBufferInput() const
void setAudioBufferInput(QAudioBufferInput *input)

Señal de notificador:

void audioBufferInputChanged()

audioInput : QAudioInput*

Devuelve el dispositivo que se está utilizando para capturar audio.

Funciones de acceso:

QAudioInput *audioInput() const
void setAudioInput(QAudioInput *input)

Señal de notificación:

void audioInputChanged()

audioOutput : QAudioOutput*

Devuelve la salida de audio de la sesión.

Funciones de acceso:

QAudioOutput *audioOutput() const
void setAudioOutput(QAudioOutput *output)

Señal de notificación:

void audioOutputChanged()

camera : QCamera*

Esta propiedad indica la cámara utilizada para grabar vídeo.

Graba vídeo o toma imágenes añadiendo una cámara a la sesión de captura mediante esta propiedad.

Funciones de acceso:

QCamera *camera() const
void setCamera(QCamera *camera)

Señal de notificación:

void cameraChanged()

imageCapture : QImageCapture*

Esta propiedad contiene el objeto utilizado para capturar imágenes fijas.

Añade un objeto « QImageCapture » a la sesión de captura para habilitar la captura de imágenes fijas desde la cámara.

Funciones de acceso:

QImageCapture *imageCapture()
void setImageCapture(QImageCapture *imageCapture)

Señal de notificación:

void imageCaptureChanged()

[since 6.12] nativeVideoSource : QObject*

Esta propiedad contiene la fuente de vídeo nativa utilizada para capturar vídeo.

Por ahora, solo es posible establecer « QGStreamerVideoSource » como fuente de vídeo nativa. En una sesión de captura solo se puede establecer una de las siguientes opciones a la vez: « QCamera » o « QGStreamerVideoSource ».

Esta enumeración se introdujo en Qt 6.12.

Funciones de acceso:

QObject *nativeVideoSource() const
void setNativeVideoSource(QObject *videoSource)

Señal de notificador:

void nativeVideoSourceChanged()

Véase también QGStreamerVideoSource y QCamera.

recorder : QMediaRecorder*

Esta propiedad contiene el objeto de grabación utilizado para capturar audio y/o vídeo.

Añade un objeto ` QMediaRecorder ` a la sesión de captura para habilitar la grabación de audio y/o vídeo desde dicha sesión.

Funciones de acceso:

QMediaRecorder *recorder()
void setRecorder(QMediaRecorder *recorder)

Señal de notificación:

void recorderChanged()

[since 6.5] screenCapture : QScreenCapture*

Esta propiedad contiene el objeto utilizado para realizar una captura de pantalla.

Para grabar una pantalla, añade un objeto de captura de pantalla a la sesión de captura mediante esta propiedad.

Esta enumeración se introdujo en Qt 6.5.

Funciones de acceso:

QScreenCapture *screenCapture()
void setScreenCapture(QScreenCapture *screenCapture)

Señal de notificador:

void screenCaptureChanged()

[since 6.8] videoFrameInput : QVideoFrameInput*

Esta propiedad contiene el objeto que se utiliza para enviar fotogramas de vídeo personalizados a QMediaRecorder o a una salida de vídeo.

Esta enumeración se introdujo en Qt 6.8.

Funciones de acceso:

QVideoFrameInput *videoFrameInput() const
void setVideoFrameInput(QVideoFrameInput *input)

Señal de notificador:

void videoFrameInputChanged()

videoOutput : QObject*

Devuelve la salida de vídeo de la sesión.

Funciones de acceso:

QObject *videoOutput() const
void setVideoOutput(QObject *output)

Señal de notificación:

void videoOutputChanged()

[since 6.6] windowCapture : QWindowCapture*

Esta propiedad contiene el objeto utilizado para capturar una ventana.

Para registrar una ventana, añade un objeto de captura de ventana a la sesión de captura mediante esta propiedad.

Esta enumeración se introdujo en Qt 6.6.

Funciones de acceso:

QWindowCapture *windowCapture()
void setWindowCapture(QWindowCapture *windowCapture)

Señal de notificador:

void windowCaptureChanged()

Documentación de las funciones de miembro

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

Crea una sesión para la captura de contenido multimedia a partir del objeto ` parent `.

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

Elimina la sesión.

void QMediaCaptureSession::setAudioInput(QAudioInput *input)

Establece el dispositivo de entrada de audio en input. Si se establece en un QAudioDevice vacío, la sesión de captura utilizará la entrada predeterminada definida por el sistema operativo.

Nota: Funciónde asignación para la propiedad audioInput.

Véase también audioInput().

void QMediaCaptureSession::setAudioOutput(QAudioOutput *output)

Establece el dispositivo de salida de audio en « output ».

Al configurar un dispositivo de salida de audio, se habilita el enrutamiento de audio desde un dispositivo de entrada de audio.

Nota: Funciónde asignación para la propiedad audioOutput.

Véase también audioOutput().

void QMediaCaptureSession::setVideoOutput(QObject *output)

Establece un objeto ` QObject` (output) como vista previa de vídeo para la sesión de captura.

Se espera que una vista previa basada en « QObject » cuente con un método « videoSink()» invocable que devuelva un « QVideoSink ».

La vista previa establecida anteriormente se separa.

Nota: Funciónsetter para la propiedad ` videoOutput`.

Véase también videoOutput().

void QMediaCaptureSession::setVideoSink(QVideoSink *sink)

Establece un objeto ` QVideoSink` (sink) como vista previa de vídeo para la sesión de captura.

Se espera que una vista previa basada en « QObject » cuente con un método « videoSink()» invocable que devuelva un « QVideoSink ».

La vista previa establecida anteriormente se desvincula.

Véase también ` videoSink()`.

QVideoSink *QMediaCaptureSession::videoSink() const

Devuelve el objeto « QVideoSink » correspondiente a la sesión.

Véase también setVideoSink().

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