QAudioSource 类

QFile destinationFile;   // Class member
QAudioSource* audio; // Class member
{
    destinationFile.setFileName("/tmp/test.raw");
    destinationFile.open( QIODevice::WriteOnly | QIODevice::Truncate );

    QAudioFormat format;
    // Set up the desired format, for example:
    format.setSampleRate(8000);
    format.setChannelCount(1);
    format.setSampleFormat(QAudioFormat::UInt8);

    QAudioDevice info = QMediaDevices::defaultAudioInput();
    if (!info.isFormatSupported(format)) {
        qWarning() << "Default format not supported, trying to use the nearest.";
    }

    audio = new QAudioSource(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;
    }
}

成员函数文档

[显式构造函数] QAudioSource::QAudioSource(const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

构造一个新的音频输入并将其附加到 parent。默认音频输入设备与输出 format 参数一起使用。

[显式构造函数] QAudioSource::QAudioSource(const QAudioDevice &audioDevice, const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

构造一个新的音频输入并将其附加到 parent。使用 audioDevice 引用的设备与输入 format 参数一起使用。

[虚析构函数] QAudioSource::~QAudioSource()

销毁此音频输入。

qsizetype QAudioSource::bufferSize() const

返回音频缓冲区大小（字节数）。

在 start() 调用之前，返回平台默认值。在 setBufferSize() 调用之前，返回通过 setBufferSize 设置的值。在 start() 之后调用，将返回实际使用的缓冲区大小，这可能不是先前通过 setBufferSize 设置的值。

参阅setBufferSize。

qsizetype QAudioSource::bytesAvailable() const

返回可读取的字节数量。

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

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()

在挂起后恢复处理音频数据。

将 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（全音量）线性缩放。超出此范围的值将被限制。

如果设备不支持调整输入音量，则音量将被忽略，输入音量将保持在1.0。

默认音量为1.0。

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

另请参阅音量。

void QAudioSource::start(QIODevice *device)

从系统的音频输入开始传输音频数据到设备。该设备必须在WriteOnly、Append或ReadWrite模式中已打开。

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

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

另请参阅QIODevice。

QIODevice *QAudioSource::start()

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

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

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

另请参阅QIODevice。

QtAudio::State QAudioSource::state() const

返回音频处理的状态。

[信号] 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().