DMediaRecorder类提供相机录制相关功能. 更多...

#include <dmediarecorder.h>

类 Dtk::Multimedia::DMediaRecorder 继承关系图:

Public 类型
enum	Quality { VeryLowQuality , LowQuality , NormalQuality , HighQuality , VeryHighQuality }
	拍照质量更多...

enum	EncodingMode { ConstantQualityEncoding , ConstantBitRateEncoding , AverageBitRateEncoding , TwoPassEncoding }
	编码质量更多...

Public 槽
void	record ()
	信号槽-相机开始录制.

void	pause ()
	信号槽-相机暂停录制.

void	stop ()
	信号槽-相机停止录制.

信号
void	recorderStateChanged (State state)
	添加相机录制的录制状态改变.

void	actualLocationChanged (const QUrl &location)
	添加相机录制的位置改变.

void	encoderSettingsChanged ()
	添加相机录制的位置改变.

void	errorOccurred (Error error, const QString &errorString)
	添加相机录制的错误发生.

void	errorChanged ()
	添加相机录制的错误发生改变.

void	metaDataChanged ()
	添加相机录制的元数据发生改变.

void	mediaFormatChanged ()
	添加相机录制的媒体格式发生改变.

void	encodingModeChanged ()
	添加相机录制的编码模式发生改变.

void	qualityChanged ()
	添加相机录制的编码质量发生改变.

void	videoResolutionChanged ()
	添加相机录制的视频像素发生改变.

void	videoFrameRateChanged ()
	添加相机录制的视频帧率发生改变.

void	videoBitRateChanged ()
	添加相机录制的视频比特率发生改变.

void	audioBitRateChanged ()
	添加相机录制的音频比特率发生改变.

void	audioChannelCountChanged ()
	添加相机录制的音频通道数发生改变.

void	audioSampleRateChanged ()
	添加相机录制的音频采样率发生改变.

Public 成员函数
	DMediaRecorder (QMediaObject *parent=nullptr)

bool	isAvailable () const
	录像功能是否可用.

QUrl	outputLocation () const
	返回录像输出文件路径.

void	setOutputLocation (const QUrl &location)
	设置录像输出文件路径.

QUrl	actualLocation () const
	返回录像输出文件真实路径.

State	recorderState () const
	返回录像录制状态.

Error	error () const
	返回相机当前录制的错误状态.

QString	errorString () const
	返回相机当前录制的错误描述.

qint64	duration () const
	返回相机当前录制的时长.

DMediaFormat	mediaFormat () const
	返回相机当前录制的时长.

void	setMediaFormat (const DMediaFormat &format)
	设置录像输出文件格式.

EncodingMode	encodingMode () const
	返回相机当前录制的编码模式.

void	setEncodingMode (EncodingMode)
	返回相机当前录制的编码模式.

Quality	quality () const
	返回相机录制的质量.

void	setQuality (Quality quality)
	设置相机录制的质量.

QSize	videoResolution () const
	返回相机录制视频的分辨率.

void	setVideoResolution (const QSize &)

void	setVideoResolution (int width, int height)
	设置相机录制视频的分辨率.

qreal	videoFrameRate () const
	返回相机录制视频的帧率.

void	setVideoFrameRate (qreal frameRate)
	设置相机录制视频的帧率.

int	videoBitRate () const
	返回相机录制视频的比特率.

void	setVideoBitRate (int bitRate)
	设置相机录制视频的比特率.

int	audioBitRate () const
	返回相机录制音频的比特率.

void	setAudioBitRate (int bitRate)
	设置相机录制音频的比特率.

int	audioChannelCount () const
	返回相机录制音频的声道数.

void	setAudioChannelCount (int channels)
	设置相机录制音频的声道数.

int	audioSampleRate () const
	返回相机录制音频的采样率.

void	setAudioSampleRate (int sampleRate)
	设置相机录制音频的采样率.

DMediaMetaData	metaData () const
	返回相机录制的元数据.

void	setMetaData (const DMediaMetaData &metaData)
	设置相机录制的元数据.

void	setMetaData (const QString &key, const QVariant &value)
	添加相机录制的元数据.

void	addMetaData (const DMediaMetaData &metaData)
	添加相机录制的元数据.

DMediaCaptureSession *	captureSession () const
	返回相机的回话.

QMediaRecorder *	platformRecoder () const
	返回相机的录制对象.

Protected 属性
QScopedPointer< DMediaRecorderPrivate >	d_ptr

详细描述

DMediaRecorder类提供相机录制相关功能.

成员枚举类型说明

◆ EncodingMode

enum Dtk::Multimedia::DMediaRecorder::EncodingMode

编码质量

枚举值
ConstantQualityEncoding	恒定的编码质量
ConstantBitRateEncoding	恒定的比特率编码
AverageBitRateEncoding	编码保持平均比特率
TwoPassEncoding	编码确定特征，二次处理

◆ Quality

enum Dtk::Multimedia::DMediaRecorder::Quality

拍照质量

枚举值
VeryLowQuality	极低质量
LowQuality	低质量
NormalQuality	正常
HighQuality	较高质量
VeryHighQuality	高质量

成员函数说明

◆ actualLocation()

QUrl DMediaRecorder::actualLocation ( ) const

返回录像输出文件真实路径.

返回: 录像输出文件真实路径.

◆ actualLocationChanged

void DMediaRecorder::actualLocationChanged ( const QUrl & location )

signal

添加相机录制的位置改变.

参数

[in] location 录制的位置.

◆ addMetaData()

void DMediaRecorder::addMetaData ( const DMediaMetaData & metaData )

添加相机录制的元数据.

参数

[in] metaData 录制的元数据.

◆ audioBitRate()

int DMediaRecorder::audioBitRate ( ) const

返回相机录制音频的比特率.

返回: 音频的比特率.

◆ audioChannelCount()

int DMediaRecorder::audioChannelCount ( ) const

返回相机录制音频的声道数.

返回: 音频的声道数.

◆ audioSampleRate()

int DMediaRecorder::audioSampleRate ( ) const

返回相机录制音频的采样率.

返回: 音频的采样率.

◆ captureSession()

DMediaCaptureSession * DMediaRecorder::captureSession ( ) const

返回相机的回话.

返回: 相机的回话的指针.

◆ duration()

qint64 DMediaRecorder::duration ( ) const

返回相机当前录制的时长.

返回: 相机当前录制的时长.

◆ encodingMode()

EncodingMode DMediaRecorder::encodingMode ( ) const

返回相机当前录制的编码模式.

返回: 相机当前录制的编码模式.

◆ error()

Error DMediaRecorder::error ( ) const

返回相机当前录制的错误状态.

返回: 相机当前录制的错误状态.

◆ errorOccurred

void DMediaRecorder::errorOccurred	(	Error	error,
		const QString &	errorString
	)

signal

添加相机录制的错误发生.

参数

[in]	error	错误状态.
[in]	errorString	错误描述.

◆ errorString()

QString DMediaRecorder::errorString ( ) const

返回相机当前录制的错误描述.

返回: 相机当前录制的错误描述.

◆ isAvailable()

bool DMediaRecorder::isAvailable ( ) const

录像功能是否可用.

返回: 录像功能是否可用，true为可用.

◆ mediaFormat()

DMediaFormat DMediaRecorder::mediaFormat ( ) const

返回相机当前录制的时长.

返回: 相机当前录制的时长.

◆ metaData()

DMediaMetaData DMediaRecorder::metaData ( ) const

返回相机录制的元数据.

返回: 录制的元数据.

◆ outputLocation()

QUrl DMediaRecorder::outputLocation ( ) const

返回录像输出文件路径.

返回: 录像输出文件路径.

◆ platformRecoder()

QMediaRecorder * DMediaRecorder::platformRecoder ( ) const

返回相机的录制对象.

返回: 相机的录制对象.

◆ quality()

Quality DMediaRecorder::quality ( ) const

返回相机录制的质量.

返回: 录制的质量.

◆ recorderState()

State DMediaRecorder::recorderState ( ) const

返回录像录制状态.

返回: 录像录制状态.

◆ recorderStateChanged

void DMediaRecorder::recorderStateChanged ( State state )

signal

添加相机录制的录制状态改变.

参数

[in] state 录制状态.

◆ setAudioBitRate()

void DMediaRecorder::setAudioBitRate ( int bitRate )

设置相机录制音频的比特率.

参数

[in] bitRate 音频的比特率.

◆ setAudioChannelCount()

void DMediaRecorder::setAudioChannelCount ( int channels )

设置相机录制音频的声道数.

参数

[in] bitRate 音频的声道数.

◆ setAudioSampleRate()

void DMediaRecorder::setAudioSampleRate ( int sampleRate )

设置相机录制音频的采样率.

参数

[in] bitRate 音频的采样率.

◆ setEncodingMode()

void DMediaRecorder::setEncodingMode ( EncodingMode )

返回相机当前录制的编码模式.

参数

[in] EncodingMode 相机当前录制的编码模式.

◆ setMediaFormat()

void DMediaRecorder::setMediaFormat ( const DMediaFormat & format )

设置录像输出文件格式.

参数

[in] format 录像输出文件格式.

◆ setMetaData() [1/2]

void DMediaRecorder::setMetaData ( const DMediaMetaData & metaData )

设置相机录制的元数据.

参数

[in] metaData 录制的元数据.

◆ setMetaData() [2/2]

void DMediaRecorder::setMetaData	(	const QString &	key,
		const QVariant &	value
	)

添加相机录制的元数据.

参数

[in]	key	录制的元数据的主键.
[in]	value	录制的元数据的主键值.

◆ setOutputLocation()

void DMediaRecorder::setOutputLocation ( const QUrl & location )

设置录像输出文件路径.

参数

[in] location 录像输出文件路径.

◆ setQuality()

void DMediaRecorder::setQuality ( Quality quality )

设置相机录制的质量.

参数

[in] quality 录制的质量.

◆ setVideoBitRate()

void DMediaRecorder::setVideoBitRate ( int bitRate )

设置相机录制视频的比特率.

参数

[in] bitRate 视频的比特率.

◆ setVideoFrameRate()

void DMediaRecorder::setVideoFrameRate ( qreal frameRate )

设置相机录制视频的帧率.

参数

[in] frameRate 视频的帧率.

◆ setVideoResolution()

void DMediaRecorder::setVideoResolution	(	int	width,
		int	height
	)

inline

设置相机录制视频的分辨率.

参数

[in]	width	视频的宽.
[in]	height	视频的高.

◆ videoBitRate()

int DMediaRecorder::videoBitRate ( ) const

返回相机录制视频的比特率.

返回: 视频的比特率.

◆ videoFrameRate()

qreal DMediaRecorder::videoFrameRate ( ) const

返回相机录制视频的帧率.

返回: 视频的帧率.

◆ videoResolution()

QSize DMediaRecorder::videoResolution ( ) const

返回相机录制视频的分辨率.

返回: 视频的分辨率.

该类的文档由以下文件生成:

include/dtkmultimedia/dmediarecorder.h
docs/dtkmultimedia/dmediarecorder.zh_CN.dox

Public 类型

Public 槽

信号

Public 成员函数

Protected 属性

详细描述

成员枚举类型说明

◆ EncodingMode

◆ Quality

成员函数说明

◆ actualLocation()

◆ actualLocationChanged

◆ addMetaData()

◆ audioBitRate()

◆ audioChannelCount()

◆ audioSampleRate()

◆ captureSession()

◆ duration()

◆ encodingMode()

◆ error()

◆ errorOccurred

◆ errorString()

◆ isAvailable()

◆ mediaFormat()

◆ metaData()

◆ outputLocation()

◆ platformRecoder()

◆ quality()

◆ recorderState()

◆ recorderStateChanged

◆ setAudioBitRate()

◆ setAudioChannelCount()

◆ setAudioSampleRate()

◆ setEncodingMode()

◆ setMediaFormat()

◆ setMetaData() [1/2]

◆ setMetaData() [2/2]

◆ setOutputLocation()

◆ setQuality()

◆ setVideoBitRate()

◆ setVideoFrameRate()

◆ setVideoResolution()

◆ videoBitRate()

◆ videoFrameRate()

◆ videoResolution()