CaptureSession QML Type
Permite capturar contenidos de audio y vídeo. Más...
| Import Statement: | import QtMultimedia |
| In C++: | QMediaCaptureSession |
Propiedades
- audioInput : AudioInput
- audioOutput : AudioOutput
- camera : Camera
- imageCapture : ImageCapture
- recorder : MediaRecorder
- screenCapture : ScreenCapture
(since 6.5) - videoOutput : VideoOutput
- windowCapture : WindowCapture
(since 6.6)
Señales
- audioInputChanged()
- audioOutputChanged()
- cameraChanged()
- imageCaptureChanged()
- recorderChanged()
- videoOutputChanged()
Descripción detallada
Este es el tipo central que gestiona la captura de medios en el dispositivo local.
Conecte una cámara y un micrófono a una CaptureSession asignando los objetos Camera y AudioInput a las propiedades correspondientes.
Capture una pantalla conectando un objeto ScreenCapture a la propiedad screenCapture.
Capture una ventana conectando un objeto WindowCapture a la propiedad windowCapture.
Habilitar una vista previa de los medios capturados asignando un elemento VideoOutput a la propiedad videoOutput.
Enrutar audio a un dispositivo de salida asignando un objeto AudioOutput a la propiedad audioOutput.
Capturar imágenes fijas desde una cámara asignando un elemento ImageCapture a la propiedad imageCapture.
Grabar audio/vídeo asignando un 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 asegurarse de que la cámara empieza a capturar fotogramas de vídeo en todas las plataformas, llame explícitamente a camera.start(), normalmente en el manejador Component.onCompleted.
Véase también Camera, MediaDevices, MediaRecorder, ImageCapture, ScreenCapture, WindowCapture, AudioInput, y VideoOutput.
Documentación de propiedades
audioInput : AudioInput
Esta propiedad contiene la entrada de audio que se está utilizando para capturar audio.
audioOutput : AudioOutput
El dispositivo de salida de audio para la sesión de captura.
Añada 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 capturar vídeo.
Grabe vídeo o tome 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ñada una interfaz ImageCapture a la sesión de captura para permitir la captura de imágenes fijas desde la cámara.
recorder : MediaRecorder
El objeto grabador utilizado para capturar audio/vídeo.
Añade un objeto MediaRcorder a la sesión de captura para permitir la grabación de audio y/o vídeo de la sesión de captura.
screenCapture : ScreenCapture [since 6.5]
El objeto utilizado para capturar una pantalla.
Grabe una pantalla añadiendo un objeto de captura de pantalla a la sesión de captura utilizando esta propiedad.
Esta propiedad se introdujo en Qt 6.5.
videoOutput : VideoOutput
El VideoOutput que es la vista previa de vídeo para la sesión de captura.
Se espera que una vista previa basada en VideoOutput tenga un método invocable videoSink() que devuelva un QVideoSink.
La vista previa previamente configurada se separa.
windowCapture : WindowCapture [since 6.6]
El objeto utilizado para capturar una ventana.
Grabe una ventana añadiendo un objeto de captura de ventana a la sesión de captura utilizando esta propiedad.
Esta propiedad se introdujo en Qt 6.6.
Documentación de señales
audioInputChanged()
Esta señal se emite cuando una entrada de audio ha cambiado.
Nota: El manejador correspondiente es onAudioInputChanged.
Véase también CaptureSession::audioInput.
audioOutputChanged()
Esta señal se emite cuando la salida de audio seleccionada ha cambiado.
Nota: El manejador correspondiente es onAudioOutputChanged.
Véase también CaptureSession::audioOutput.
cameraChanged()
Esta señal se emite cuando la cámara seleccionada ha cambiado.
Nota: El manejador correspondiente es onCameraChanged.
Véase también CaptureSession::camera.
imageCaptureChanged()
Esta señal se emite cuando la interfaz seleccionada ha cambiado.
Nota: El manejador correspondiente es onImageCaptureChanged.
Véase también CaptureSession::camera.
recorderChanged()
Esta señal se emite cuando la grabadora seleccionada ha cambiado.
Nota: El manejador correspondiente es onRecorderChanged.
Véase también CaptureSession::recorder.
videoOutputChanged()
Esta señal se emite cuando la salida de vídeo seleccionada ha cambiado.
Nota: El manejador 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.
