QMediaCaptureSession Class

The QMediaCaptureSession class allows capturing of audio and video content. 更多...

头：	#include <QMediaCaptureSession>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake:	QT += multimedia
实例化：	CaptureSession
继承：	QObject

• 所有成员列表，包括继承成员

特性

audioInput : QAudioInput* audioOutput : QAudioOutput* camera : QCamera* imageCapture : QImageCapture*

recorder : QMediaRecorder* screenCapture : QScreenCapture* videoOutput : QObject*

公共函数

	QMediaCaptureSession (QObject * parent = nullptr)
virtual	~QMediaCaptureSession ()
QAudioInput *	audioInput () const
QAudioOutput *	audioOutput () const
QCamera *	camera () const
QImageCapture *	imageCapture ()
QMediaRecorder *	recorder ()
QScreenCapture *	screenCapture ()
void	setAudioInput (QAudioInput * input )
void	setAudioOutput (QAudioOutput * output )
void	setCamera (QCamera * camera )
void	setImageCapture (QImageCapture * imageCapture )
void	setRecorder (QMediaRecorder * recorder )
void	setScreenCapture (QScreenCapture * screenCapture )
void	setVideoOutput (QObject * output )
void	setVideoSink (QVideoSink * sink )
QObject *	videoOutput () const
QVideoSink *	videoSink () const

信号

void	audioInputChanged ()
void	audioOutputChanged ()
void	cameraChanged ()
void	imageCaptureChanged ()
void	recorderChanged ()
void	screenCaptureChanged ()
void	videoOutputChanged ()

详细描述

The QMediaCaptureSession is the central class that manages capturing of media on the local device.

You can connect a camera and a microphone to QMediaCaptureSession using setCamera () 和 setAudioInput (). A preview of the captured media can be seen by setting a QVideoSink of QVideoWidget 使用 setVideoOutput () and heard by routing the audio to an output device using setAudioOutput ().

You can capture still images from a camera by setting a QImageCapture object on the capture session, and record audio/video using a QMediaRecorder .

另请参阅 QCamera , QAudioDevice , QMediaRecorder , QImageCapture ，和 QMediaRecorder .

特性文档编制

audioInput : QAudioInput *

Returns the device that is being used to capture audio.

访问函数：

QAudioInput *	audioInput () const
void	setAudioInput (QAudioInput * input )

通知程序信号：

void	audioInputChanged ()

audioOutput : QAudioOutput *

Returns the audio output for the session.

访问函数：

QAudioOutput *	audioOutput () const
void	setAudioOutput (QAudioOutput * output )

通知程序信号：

void	audioOutputChanged ()

camera : QCamera *

This property holds the camera used to capture video.

Record video or take images by adding a camera to the capture session using this property,

访问函数：

QCamera *	camera () const
void	setCamera (QCamera * camera )

通知程序信号：

void	cameraChanged ()

imageCapture : QImageCapture *

This property holds the object used to capture still images.

添加 QImageCapture object to the capture session to enable capturing of still images from the camera.

访问函数：

QImageCapture *	imageCapture ()
void	setImageCapture (QImageCapture * imageCapture )

通知程序信号：

void	imageCaptureChanged ()

recorder : QMediaRecorder *

This property holds the recorder object used to capture audio/video.

添加 QMediaRecorder object to the capture session to enable recording of audio and/or video from the capture session.

访问函数：

QMediaRecorder *	recorder ()
void	setRecorder (QMediaRecorder * recorder )

通知程序信号：

void	recorderChanged ()

[since 6.5] screenCapture : QScreenCapture *

This property holds the object used to capture a window or screen view.

Record a screen or window view by adding a screen capture objet to the capture session using this property.

This property was introduced in Qt 6.5.

访问函数：

QScreenCapture *	screenCapture ()
void	setScreenCapture (QScreenCapture * screenCapture )

通知程序信号：

void	screenCaptureChanged ()

videoOutput : QObject *

Returns the video output for the session.

访问函数：

QObject *	videoOutput () const
void	setVideoOutput (QObject * output )

通知程序信号：

void	videoOutputChanged ()

成员函数文档编制

[explicit] QMediaCaptureSession:: QMediaCaptureSession ( QObject * parent = nullptr)

Creates a session for media capture from the parent 对象。

[虚拟] QMediaCaptureSession:: ~QMediaCaptureSession ()

Destroys the session.

void QMediaCaptureSession:: setAudioInput ( QAudioInput * input )

Sets the audio input device to input . If setting it to an empty QAudioDevice the capture session will use the default input as defined by the operating system.

注意： setter 函数对于特性 audioInput .

另请参阅 audioInput ().

void QMediaCaptureSession:: setAudioOutput ( QAudioOutput * output )

Sets the audio output device to output .

注意： setter 函数对于特性 audioOutput .

另请参阅 audioOutput ().

void QMediaCaptureSession:: setVideoOutput ( QObject * output )

设置 QObject , ( output ), to a video preview for the capture session.

A QObject based preview is expected to have an invokable videoSink () method that returns a QVideoSink .

The previously set preview is detached.

注意： setter 函数对于特性 videoOutput .

另请参阅 videoOutput ().

void QMediaCaptureSession:: setVideoSink ( QVideoSink * sink )

设置 QVideoSink , ( sink ), to a video preview for the capture session.

A QObject based preview is expected to have an invokable videoSink () method that returns a QVideoSink .

The previously set preview is detached.

另请参阅 videoSink ().

QVideoSink *QMediaCaptureSession:: videoSink () const

返回 QVideoSink for the session.

另请参阅 setVideoSink ().

内容

1. 特性

2. 公共函数

3. 信号

4. 详细描述