CaptureSession QML Type

Allows capturing of audio and video content. More...

Import Statement: import QtMultimedia
Instantiates: QMediaCaptureSession

Properties

Signals

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.

Capture a window by connecting a WindowCapture object to the windowCapture 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 Camera, MediaDevices, MediaRecorder, ImageCapture, ScreenCapture, WindowCapture, AudioInput, and VideoOutput.

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.


screenCapture : ScreenCapture [since 6.5]

The object used to capture a screen.

Record a screen by adding a screen capture objet 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.


windowCapture : WindowCapture [since 6.6]

The object used to capture a window.

Record a window by adding a window capture object to the capture session using this property.

This property was introduced in Qt 6.6.


Signal Documentation

audioInputChanged()

This signal is emitted when an audio input has changed.

Note: The corresponding handler is onAudioInputChanged.

See also CaptureSession::audioInput.


audioOutputChanged()

This signal is emitted when the selected audio output has changed.

Note: The corresponding handler is onAudioOutputChanged.

See also CaptureSession::audioOutput.


cameraChanged()

This signal is emitted when the selected camera has changed.

Note: The corresponding handler is onCameraChanged.

See also CaptureSession::camera.


imageCaptureChanged()

This signal is emitted when the selected interface has changed.

Note: The corresponding handler is onImageCaptureChanged.

See also CaptureSession::camera.


recorderChanged()

This signal is emitted when the selected recorder has changed.

Note: The corresponding handler is onRecorderChanged.

See also CaptureSession::recorder.


videoOutputChanged()

This signal is emitted when the selected video output has changed.

Note: The corresponding handler is onVideoOutputChanged.

See also CaptureSession::videoOutput.