QAudioSource Class

QFiledestinationFile;// 类成员QAudioSource*audio;// 类成员{ destinationFile.setFileName("/tmp/test.raw"); destinationFile.open( QIODevice::WriteOnly|::Truncate QIODevice::Truncate )；    QAudioFormatformat;// 设置所需的格式，例如：format.setSampleRate(8000); format.setChannelCount(1); format.setSampleFormat(QAudioFormat::UInt8)；    QAudioDeviceinfo=QMediaDevices::defaultAudioInput();if(!info.isFormatSupported(format)) {        qWarning() << "Default format not supported, trying to use the nearest.";
    } 音频= newQAudioSource(format, this); connect(audio, &QAudioSource::stateChanged, this, &AudioInputExample::handleStateChanged)；    QTimer::singleShot(3000, this, &AudioInputExample::stopRecording); audio->start(&destinationFile);// Records audio for 3000ms}

void AudioInputExample::stopRecording()
{
    audio->stop();
    destinationFile.close();
    delete audio;
}

void AudioInputExample::handleStateChanged(QAudio::State newState)
{
    switch (newState) {
        case QAudio::StoppedState:
            if (audio->error() != QAudio::NoError) {
                // Error handling
            } else {
                // Finished recording
            }
            break;

        case QAudio::ActiveState:
            // Started recording - read from IO device
            break;

        default:
            // ... other cases as appropriate
            break;
    }
}

成员函数文档

[explicit] QAudioSource::QAudioSource(const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

创建一个新的音频输入，并将其连接到parent 。默认的音频输入设备与输出format 参数一起使用。

[explicit] QAudioSource::QAudioSource(const QAudioDevice &audioDevice, const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

创建一个新的音频输入，并将其连接到parent 。由audioDevice 引用的设备与输入format 参数一起使用。

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

销毁此音频输入。

qsizetype QAudioSource::bufferSize() const

以字节为单位返回音频缓冲区大小。

如果在start() 之前调用，则返回平台默认值。如果在start() 之前调用setBufferSize() ，则返回setBufferSize() 设置的值。如果在start() 之后调用，则返回实际使用的缓冲区大小。这可能与setBufferSize() 之前设置的值不同。

另请参见 setBufferSize()。

qsizetype QAudioSource::bytesAvailable() const

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

注意：返回值只有在QtAudio::ActiveState 或QtAudio::IdleState 状态下有效，否则返回 0。

qint64 QAudioSource::elapsedUSecs() const

返回调用start() 后的微秒数，包括闲置和挂起状态下的时间。

QtAudio::Error QAudioSource::error() const

返回错误状态。

QAudioFormat QAudioSource::format() const

返回正在使用的QAudioFormat 。

bool QAudioSource::isNull() const

如果音频源是null ，则返回true ，否则返回false 。

qint64 QAudioSource::processedUSecs() const

返回自调用start() 以来处理的音频数据量，单位为微秒。

void QAudioSource::reset()

删除缓冲区中的所有音频数据，将缓冲区重置为零。

void QAudioSource::resume()

在suspend() 之后恢复处理音频数据。

将error() 设为QtAudio::NoError 。如果之前调用了 start(QIODevice*)，则将state() 设为QtAudio::ActiveState 。如果之前调用过start() ，则将state() 设置为QtAudio::IdleState 。发出stateChanged() 信号。

void QAudioSource::setBufferSize(qsizetype value)

将音频缓冲区大小设置为value 字节。

注意：此函数可在start() 之前随时调用，在start() 之后调用此函数将被忽略。不应认为所设置的缓冲区大小就是实际使用的缓冲区大小，在start() 之后随时调用bufferSize() 都将返回实际使用的缓冲区大小。

另请参阅 bufferSize()。

void QAudioSource::setVolume(qreal volume)

将输入音量设置为volume 。

音量从0.0 （静音）到1.0 （全音量）线性缩放。超出此范围的值将被箝位。

如果设备不支持调整输入音量，那么volume 将被忽略，输入音量将保持为 1.0。

默认音量为1.0 。

注意：调整音量将改变该音频流的音量，而不是全局音量。

另请参阅 volume() 。

QIODevice *QAudioSource::start()

返回用于从系统音频输入传输数据的内部QIODevice 的指针。该设备已经打开，read() 可以直接从中读取数据。

如果QAudioSource 能够访问系统的音频设备，state() 将返回QtAudio::IdleState ，error() 将返回QtAudio::NoError ，并发出stateChanged() 信号。

如果在此过程中出现问题，error() 将返回QtAudio::OpenError,state() 将返回QtAudio::StoppedState 并发出stateChanged() 信号。

另请参见 QIODevice 。

void QAudioSource::start(QIODevice *device)

开始从系统音频输入端向device 传输音频数据。device 必须在WriteOnly 、Append 或ReadWrite 模式下打开。

如果QAudioSource 能够成功获取音频数据，state() 将返回QtAudio::ActiveState 或QtAudio::IdleState ，error() 将返回QtAudio::NoError ，并发出stateChanged() 信号。

如果在此过程中出现问题，error() 将返回QtAudio::OpenError ，state() 将返回QtAudio::StoppedState ，并发出stateChanged() 信号。

另请参见 QIODevice 。

QtAudio::State QAudioSource::state() const

返回音频处理的状态。

[signal] void QAudioSource::stateChanged(QtAudio::State state)

该信号在设备state 发生变化时发出。

void QAudioSource::stop()

停止音频输入，脱离系统资源。

将error() 设为QtAudio::NoError ，将state() 设为QtAudio::StoppedState ，并发出stateChanged() 信号。

void QAudioSource::suspend()

停止处理音频数据，保留缓冲音频数据。

将error() 设置为QtAudio::NoError ，将state() 设置为QtAudio::SuspendedState ，并发出stateChanged() 信号。

qreal QAudioSource::volume() const

返回输入音量。

如果设备不支持调节输入音量，返回值将为 1.0。

另请参阅 setVolume()。