CaptureSession QML Type▲
-
Import Statement: import QtMultimedia
-
Instantiates:: QMediaCaptureSession
-
Group: CaptureSession is part of multimedia_qml, multimedia_audio_qml, multimedia_video_qml
Detailed Description▲
This is the central type that manages capturing of media on the local device.
Connect a camera and a microphone to a CaptureSession by assigning Camera and AudioInput objects to the relevant properties.
Capture a screen by connecting a ScreenCapture object to the screenCapture property.
Enable a preview of the captured media by assigning a VideoOutput element to the videoOutput property.
Route audio to an output device by assigning an AudioOutput object to the audioOutput property.
Capture still images from a camera by assigning an ImageCapture to the imageCapture property.
Record audio/video by assigning a MediaRecorder to the recorder property.
CaptureSession {
id: captureSession
camera: Camera {
id: camera
}
imageCapture: ImageCapture {
id: imageCapture
}
recorder: MediaRecorder {
id: recorder
}
videoOutput: preview
}See Also▲
See also Camera, MediaDevices, MediaRecorder, ImageCapture, AudioInput, VideoOutput, ScreenCapture
Property Documentation▲
audioInput : AudioInput▲
This property holds the audio input that is being used to capture audio.
audioOutput : AudioOutput▲
The audio output device for the capture session.
Add an AudioOutput device to the capture session to enable audio routing from an AudioInput device.
camera : Camera▲
The camera used to capture video.
Record video or take images by adding a camera to the capture session using this property.
imageCapture : ImageCapture▲
The object used to capture still images.
Add an ImageCapture interface to the capture session to enable capturing of still images from the camera.
recorder : MediaRecorder▲
The recorder object used to capture audio/video.
Add a MediaRcorder object to the capture session to enable recording of audio and/or video from the capture session.
[since 6.5] screenCapture : ScreenCapture▲
The object used to capture a screen.
Record a screen by adding a screen capture object to the capture session using this property.
This property was introduced in Qt 6.5.
videoOutput : VideoOutput▲
The VideoOutput that is the video preview for the capture session.
A VideoOutput based preview is expected to have an invokable videoSink() method that returns a QVideoSink.
The previously set preview is detached.
Signal Documentation▲
audioInputChanged()▲
This signal is emitted when an audio input has changed.
The corresponding handler is onAudioInputChanged.
See Also▲
See also CaptureSession::audioInput
audioOutputChanged()▲
This signal is emitted when the selected audio output has changed.
The corresponding handler is onAudioOutputChanged.
See Also▲
See also CaptureSession::audioOutput
cameraChanged()▲
This signal is emitted when the selected camera has changed.
The corresponding handler is onCameraChanged.
See Also▲
See also CaptureSession::camera
imageCaptureChanged()▲
This signal is emitted when the selected interface has changed.
The corresponding handler is onImageCaptureChanged.
See Also▲
See also CaptureSession::camera
recorderChanged()▲
This signal is emitted when the selected recorder has changed.
The corresponding handler is onRecorderChanged.
See Also▲
See also CaptureSession::recorder
videoOutputChanged()▲
This signal is emitted when the selected video output has changed.
The corresponding handler is onVideoOutputChanged.
See Also▲
See also CaptureSession::videoOutput