QMediaRecorder Class

QMediaCaptureSession session;
QAudioInput audioInput;
session.setAudioInput(&input);
QMediaRecorder recorder;
session.setRecorder(&recorder);
recorder.setQuality(QMediaRecorder::HighQuality);
recorder.setOutputLocation(QUrl::fromLocalFile("test.mp3"));
recorder.record();

成员函数 文档

QMediaRecorder::QMediaRecorder(QObject *parent = nullptr)

构造一个媒体记录器。媒体记录器是parent 的子节点。

[override virtual noexcept] QMediaRecorder::~QMediaRecorder()

销毁媒体记录器对象。

[signal] void QMediaRecorder::actualLocationChanged(const QUrl &location)

记录介质的实际location 发生变化的信号。该信号通常在开始录制时发出。

void QMediaRecorder::addMetaData(const QMediaMetaData &metaData)

为记录介质添加metaData 。

int QMediaRecorder::audioBitRate() const

返回压缩音频流的比特率（比特/秒）。

另请参阅 setAudioBitRate().

[signal] void QMediaRecorder::audioBitRateChanged()

录音音频比特率发生变化时发出的信号。

int QMediaRecorder::audioChannelCount() const

返回音频通道数。

另请参阅 setAudioChannelCount().

[signal] void QMediaRecorder::audioChannelCountChanged()

当录音音频通道数发生变化时发出信号。

int QMediaRecorder::audioSampleRate() const

以 Hz 为单位返回音频采样率。

另请参阅 setAudioSampleRate().

[signal] void QMediaRecorder::audioSampleRateChanged()

录音音频采样率发生变化时发出的信号。

QMediaCaptureSession *QMediaRecorder::captureSession() const

返回媒体捕捉会话。

[signal] void QMediaRecorder::durationChanged(qint64 duration)

记录介质duration 已更改的信号。

QMediaRecorder::EncodingMode QMediaRecorder::encodingMode() const

返回编码模式。

另请参阅 setEncodingMode() 和EncodingMode 。

[signal] void QMediaRecorder::encodingModeChanged()

编码模式改变时发出的信号。

[signal] void QMediaRecorder::errorOccurred(QMediaRecorder::Error error, const QString &errorString)

error 发生错误的信号，errorString 包含错误描述。

bool QMediaRecorder::isAvailable() const

如果媒体记录器服务准备就绪，则返回true 。

[signal] void QMediaRecorder::metaDataChanged()

媒体对象的元数据已更改的信号。

如果多个元数据元素发生变化，则会发出一次 metaDataChanged() 信号。

QIODevice *QMediaRecorder::outputDevice() const

返回媒体内容的输出 IO 设备。

另请参阅 setOutputDevice()。

[slot] void QMediaRecorder::pause()

暂停录音。

记录仪状态更改为QMediaRecorder::PausedState 。

根据平台的不同，可能不支持暂停录音。在这种情况下，记录仪状态保持不变。

[signal] void QMediaRecorder::qualityChanged()

当记录质量发生变化时发出信号。

[slot] void QMediaRecorder::record()

开始录音。

虽然记录器状态会立即变为 c{QMediaRecorder::RecordingState}，但录音可能会异步开始。

如果记录失败，error() 信号会发出，记录器状态重置回QMediaRecorder::StoppedState 。

该方法根据其生成规则更新actualLocation 。

QMediaRecorder::RecorderState QMediaRecorder::recorderState() const

返回当前媒体记录器状态。

另请参阅 QMediaRecorder::RecorderState 。

[signal] void QMediaRecorder::recorderStateChanged(QMediaRecorder::RecorderState state)

媒体记录器state 已更改的信号。

void QMediaRecorder::setAudioBitRate(int bitRate)

设置音频bitRate ，单位为比特/秒。

另请参阅 audioBitRate().

void QMediaRecorder::setAudioChannelCount(int channels)

设置音频channels 的数量。

值为 -1 表示录音机应根据音频源的可用性和编解码器的限制做出最佳选择。

另请参阅 audioChannelCount() 。

void QMediaRecorder::setAudioSampleRate(int sampleRate)

设置音频sampleRate ，单位为 Hz。

-1 表示录音机应根据音频源的可用性和编解码器的限制做出最佳选择。

另请参阅 audioSampleRate().

void QMediaRecorder::setEncodingMode(QMediaRecorder::EncodingMode mode)

设置编码mode 。

如果设置了ConstantQualityEncoding ，则使用质量编码参数，忽略比特率，否则使用比特率。

另请参阅 encodingMode() 和EncodingMode 。

void QMediaRecorder::setMetaData(const QMediaMetaData &metaData)

将元数据设置为metaData 。

另请参阅 metaData() 。

void QMediaRecorder::setOutputDevice(QIODevice *device)

为媒体内容设置输出 IO 设备。

device 必须在录制开始前以WriteOnly 或ReadWrite 模式打开。

媒体记录器不拥有指定device 的所有权。如果已开始录制，则必须保持设备存活并打开，直到发出信号recorderStateChanged(StoppedState) 。

除非指定的device 是null ，否则该方法会立即重置actualLocation 。

如果为记录器分配了可写输出设备，则outputLocation 将被忽略，记录开始时也不会生成actualLocation 。这种行为将来可能会改变，因此我们建议只设置一个输出，即outputLocation 或outputDevice 。

QMediaRecorder::setOutputDevice 仅支持 FFmpeg 后端。

另请参阅 outputDevice() 和outputLocation 。

void QMediaRecorder::setVideoBitRate(int bitRate)

设置视频bitRate ，单位为比特/秒。

另请参阅 videoBitRate().

void QMediaRecorder::setVideoFrameRate(qreal frameRate)

设置视频frameRate 。

值为 0 表示录像机应根据视频源的可用性和编解码器的限制做出最佳选择。

另请参阅 videoFrameRate() 。

void QMediaRecorder::setVideoResolution(const QSize &size)

将编码视频的分辨率设置为size 。

传递空QSize ，使录像机根据视频源的可用分辨率和编解码器的限制选择最佳分辨率。

另请参阅 videoResolution().

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

设置编码视频分辨率的width 和height 。

这是一个重载函数。

[slot] void QMediaRecorder::stop()

记录盒将停止记录。不过，处理待处理的视频和音频数据可能仍需要一些时间。一旦媒体记录器的状态变为QMediaRecorder::StoppedState ，记录即告完成。

int QMediaRecorder::videoBitRate() const

返回压缩视频流的比特率（比特/秒）。

另请参阅 setVideoBitRate().

[signal] void QMediaRecorder::videoBitRateChanged()

录制视频比特率发生变化时发出的信号。

qreal QMediaRecorder::videoFrameRate() const

返回视频帧频。

另请参阅 setVideoFrameRate().

[signal] void QMediaRecorder::videoFrameRateChanged()

录像帧频发生变化时发出的信号。

QSize QMediaRecorder::videoResolution() const

返回编码视频的分辨率。

另请参阅 setVideoResolution().

[signal] void QMediaRecorder::videoResolutionChanged()

视频录制分辨率发生变化时发出的信号。