CaptureSession QML Type
Permite grabar contenido de audio y vídeo. Más...
| Import Statement: | import QtMultimedia |
| In C++: | QMediaCaptureSession |
Propiedades
- audioInput : AudioInput
- audioOutput : AudioOutput
- camera : Camera
- imageCapture : ImageCapture
- nativeVideoSource : GStreamerVideoSource
(since 6.12) - recorder : MediaRecorder
- screenCapture : ScreenCapture
(since 6.5) - videoOutput : VideoOutput
- windowCapture : WindowCapture
(since 6.6)
Señales
- audioInputChanged()
- audioOutputChanged()
- cameraChanged()
- imageCaptureChanged()
- nativeVideoSourceChanged()
- recorderChanged()
- videoOutputChanged()
Descripción detallada
Este es el tipo principal que gestiona la captura de contenido multimedia en el dispositivo local.
Conecta una cámara y un micrófono a una CaptureSession asignando objetos Camera y AudioInput a las propiedades correspondientes.
Captura una pantalla conectando un objeto ` ScreenCapture ` a la propiedad ` screenCapture `.
Captura una ventana conectando un objeto ` WindowCapture ` a la propiedad ` windowCapture `.
Habilita una vista previa del contenido multimedia capturado asignando un elemento ` VideoOutput ` a la propiedad ` videoOutput `.
Envía el audio a un dispositivo de salida asignando un objeto ` AudioOutput ` a la propiedad ` audioOutput `.
Captura imágenes fijas desde una cámara asignando un ` ImageCapture ` a la propiedad ` imageCapture `.
Graba audio o vídeo asignando un objeto ` MediaRecorder ` a la propiedad `recorder`.
CaptureSession {
id: captureSession
camera: Camera {
id: camera
}
imageCapture: ImageCapture {
id: imageCapture
}
recorder: MediaRecorder {
id: recorder
}
videoOutput: preview
Component.onCompleted: {
camera.start()
}
}Nota: Para garantizar que la cámara comience a capturar fotogramas de vídeo en todas las plataformas, llama explícitamente a `camera.start()`, normalmente en el controlador `Component.onCompleted`.
Véase también Camera, MediaDevices, MediaRecorder, ImageCapture, ScreenCapture, WindowCapture, GStreamerVideoSource, AudioInput y VideoOutput.
Documentación de la propiedad
audioInput : AudioInput
Esta propiedad contiene la entrada de audio que se está utilizando para capturar el sonido.
audioOutput : AudioOutput
El dispositivo de salida de audio para la sesión de captura.
Añade un dispositivo « AudioOutput » a la sesión de captura para habilitar el enrutamiento de audio desde un dispositivo « AudioInput ».
camera : Camera
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.
imageCapture : ImageCapture
El objeto utilizado para capturar imágenes fijas.
Añade una interfaz « ImageCapture » a la sesión de captura para permitir la captura de imágenes fijas desde la cámara.
nativeVideoSource : GStreamerVideoSource [since 6.12]
La fuente de vídeo nativa utilizada para capturar vídeo.
Por ahora, solo es posible establecer GStreamerVideoSource como fuente de vídeo nativa. En una sesión de captura solo se puede establecer una de estas dos opciones a la vez: Camera o GStreamerVideoSource.
Esta propiedad se introdujo en Qt 6.12.
Véase también GStreamerVideoSource y Camera.
recorder : MediaRecorder
El objeto de grabación que se utiliza para capturar audio y/o vídeo.
Añade un objeto MediaRecorder a la sesión de captura para habilitar la grabación de audio y/o vídeo desde dicha sesión.
screenCapture : ScreenCapture [since 6.5]
El objeto utilizado para realizar una captura de pantalla.
Graba una pantalla añadiendo un objeto de captura de pantalla a la sesión de captura mediante esta propiedad.
Esta propiedad se introdujo en Qt 6.5.
videoOutput : VideoOutput
El objeto ` VideoOutput `, que corresponde a la vista previa de vídeo de la sesión de captura.
Se espera que una vista previa basada en un ` VideoOutput ` cuente con un método `videoSink()` invocable que devuelva un ` QVideoSink`.
Se desvincula la vista previa establecida anteriormente.
windowCapture : WindowCapture [since 6.6]
El objeto utilizado para capturar una ventana.
Para grabar una ventana, añade un objeto de captura de ventana a la sesión de captura mediante esta propiedad.
Esta propiedad se introdujo en Qt 6.6.
Documentación de señales
audioInputChanged()
Esta señal se emite cuando se produce un cambio en una entrada de audio.
Nota: El controlador correspondiente es onAudioInputChanged.
Véase también CaptureSession::audioInput.
audioOutputChanged()
Esta señal se emite cuando cambia la salida de audio seleccionada.
Nota: El controlador correspondiente es onAudioOutputChanged.
Véase también CaptureSession::audioOutput.
cameraChanged()
Esta señal se emite cuando cambia la cámara seleccionada.
Nota: El controlador correspondiente es onCameraChanged.
Véase también CaptureSession::camera.
imageCaptureChanged()
Esta señal se emite cuando cambia la interfaz seleccionada.
Nota: El controlador correspondiente es onImageCaptureChanged.
Véase también CaptureSession::camera.
nativeVideoSourceChanged()
Esta señal se emite cuando cambia la fuente de vídeo nativa seleccionada.
Nota: El controlador correspondiente es onNativeVideoSourceChanged.
Véase también CaptureSession::nativeVideoSource.
recorderChanged()
Esta señal se emite cuando cambia la grabadora seleccionada.
Nota: El controlador correspondiente es onRecorderChanged.
Véase también CaptureSession::recorder.
videoOutputChanged()
Esta señal se emite cuando cambia la salida de vídeo seleccionada.
Nota: El controlador correspondiente es onVideoOutputChanged.
Véase también CaptureSession::videoOutput.
© 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.