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
| void | audioBufferInputChanged() |
| void | audioInputChanged() |
| void | audioOutputChanged() |
| void | cameraChanged() |
| void | imageCaptureChanged() |
| void | nativeVideoSourceChanged() |
| void | recorderChanged() |
| void | screenCaptureChanged() |
| void | videoFrameInputChanged() |
| void | videoOutputChanged() |
| void | windowCaptureChanged() |
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.