[TOC]

QAbstractAudioInput类


QAbstractAudioInput类为QAudioInput类提供了访问音频设备的方法。(通过插件的形式)

属性方法
Header:#include <QAbstractAudioInput>
qmake:QT += multimedia
Inherits:QObject

简述

公有的函数

类型方法
virtual intbufferSize() const = 0
virtual intbytesReady() const = 0
virtual qint64elapsedUSecs() const = 0
virtual QAudio::Errorerror() const = 0
virtual QAudioFormatformat() const = 0
virtual intnotifyInterval() const = 0
virtual intperiodSize() const = 0
virtual qint64processedUSecs() const = 0
virtual voidreset() = 0
virtual voidresume() = 0
virtual voidsetBufferSize(int value) = 0
virtual voidsetFormat(const QAudioFormat &fmt) = 0
virtual voidsetNotifyInterval(int ms) = 0
virtual voidsetVolume(qreal) = 0
virtual voidstart(QIODevice *device) = 0
virtual QIODevice*start() = 0
virtual QAudio::Statestate() const = 0
virtual voidstop() = 0
virtual voidsuspend() = 0
virtual qrealvolume() const = 0

信号

类型方法
voiderrorChanged(QAudio::Error error)
voidnotify()
voidstateChanged(QAudio::State state)

详细描述

QAbstractAudioInput类为QAudioInput类提供了访问音频设备的方法。(通过插件的形式) QAudioDeviceInput类中保留了一个QAbstractAudioInput的实例,并且调用的函数与QAbstractAudioInput的一致。

译者注:也就是说QAudioDeviceInput调用的函数实际上是QAbstractAudioInput的函数,就封装了一层相同函数名吧。可以自己看看源码。)

这意味着QAbstractAudioInput是实现音频功能的。有关功能的描述,可以参考QAudioInput类。 另见QAudioInput函数


成员函数文档


int QAbstractAudioInput::bufferSize() const [纯虚函数]

以毫秒为单位返回音频缓冲区的大小


int QAbstractAudioInput::bytesReady() const [纯虚函数]

以字节(bytes)为单位返回可读取的音频数据量


qint64 QAbstractAudioInput**::elapsedUSecs() const [纯虚函数]

返回调用start()函数以来的毫秒数,包括空闲时间与挂起状态的时间


QAudio::Error QAbstractAudioInput::error() const [纯虚函数]

返回错误的状态


void QAbstractAudioInput::errorChanged(QAudio::Error error) [信号signal]

当错误状态改变时,该信号被发射


QAudioFormat QAbstractAudioInput::format() const [纯虚函数]

返回正在使用的QAudioFormat(这个类是储存音频流相关的参数信息的) 另参见setFormat()函数


void QAbstractAudioInput::notify() [信号signal]

当音频数据的x ms通过函数setNotifyInterval()调用之后,这个信号会被发射。


int QAbstractAudioInput::notifyInterval() const [纯虚函数]

以毫秒为单位返回通知间隔


int QAbstractAudioInput::periodSize() const [纯虚函数]

以字节为单位返回其周期


qint64 QAbstractAudioInput::processedUSecs() const [纯虚函数]

返回自start()函数被调用之后处理的音频数据量(以毫秒为单位)


void QAbstractAudioInput::reset() [纯虚函数]

将所有音频数据放入缓冲区,并将缓冲区重置为零


void QAbstractAudioInput::resume() [纯虚函数]

在音频数据暂停后继续处理


void QAbstractAudioInput::setBufferSize(int value) [纯虚函数]

将音频缓冲区大小设置为value大小(以毫秒为单位) 另参阅bufferSize()函数


void QAbstractAudioInput::setFormat(const QAudioFormat &fmt) [纯虚函数]

设置音频格式,设置格式的时候只能在QAudio的状态为StoppedState时(QAudio::StoppedState)


void QAbstractAudioInput::setNotifyInterval(int ms) [纯虚函数]

设置发送notify()信号的时间间隔。这个ms时间间隔与操作系统平台相关,并不是实际的ms数。


void QAbstractAudioInput::setVolume(qreal) [纯虚函数]

另见volume()函数 (设置这里应该是设置音量的值,Volume在英文中有音量的意思,官方文档这里根本就没有任何说明,说去参考valume()函数,可是valume()说又去参考SetValume()函数,这是互相甩锅的节奏么???坑爹啊!!!)


void QAbstractAudioInput::start(QIODevice *device) [纯虚函数]

使用输入参数QIODevice *device来传输数据


QIODevice *QAbstractAudioInput::start() [纯虚函数]

返回一个指向正在用于正在处理数据QIODevice的指针。这个指针可以用来直接读取音频数据。


QAudio::State QAbstractAudioInput::state() const [纯虚函数]

返回处理音频的状态


void QAbstractAudioInput::stateChanged(QAudio::State state) [信号signal]

当设备状态改变时,会发出这个信号


void QAbstractAudioInput::stop() [纯虚函数]

停止音频输入(因为这是个QAbstractAudioInput类啊,输入类啊,暂时这么解释比较合理。)


void QAbstractAudioInput::suspend() [纯虚函数]

停止处理音频数据,保存缓冲的音频数据


qreal QAbstractAudioInput::volume() const [纯虚函数]

另见setVolume()(内心os:参考我解释setVolume()函数的说明,这里应该是返回其音量)