QAudioSink Class

QFilesourceFile;// 类成员。QAudioSink*audio;// class member.{ sourceFile.setFileName("/tmp/test.raw"); sourceFile.open(QIODevice::ReadOnly)；    QAudioFormatformat;// 设置格式，例如format.setSampleRate(44100); format.setChannelCount(1); format.setSampleFormat(QAudioFormat::Int16)；    QAudioDeviceinfo(QMediaDevices::defaultAudioOutput());if(!info.isFormatSupported(format)) {        qWarning() << "Raw audio format not supported by backend, cannot play audio.";
       return; } audio= newQAudioSink(format, this); connect(audio、 QAudioSink::stateChanged, this, &AudioInputExample::handleStateChanged); audio->start(&sourceFile); }

void AudioOutputExample::stopAudioOutput()
{
    audio->stop();
    sourceFile.close();
    delete audio;
}

QAudioSink*floatphase;//  class  member.   QAudioFormatformat;// 设置格式，例如format.setSampleRate(44100); format.setChannelCount(2); format.setSampleFormat(QAudioFormat::Float)；    QAudioDeviceinfo(QMediaDevices::defaultAudioOutput());if(!info.isFormatSupported(format)) {        qWarning() << "Raw audio format not supported by backend, cannot play audio.";
       return; } audio= newQAudioSink(format, this);floatphaseIncrement= 2 *M_PI* 220.0 /format.sampleRate();// 220 Hz 正弦波 audio->start([&phase,phaseIncrement](QSpan<float>interleavedAudioBuffer) {// 音频回调不应调用任何可能阻塞的函数 // 用正弦波填充音频缓冲区 const intsampleCount=interleavedAudioBuffer.size()/ 2;// Stereo, so divide by 2 for(inti= 0; i<sampleCount;++i) {floatsample=std::sin(phase); interleavedAudioBuffer[i* 2] =sample;// Left channelinterleavedAudioBuffer[i* 2 + 1] =sample;// Right channelphase+=phaseIncrement;//Increment phase for next sample} });if(！audio->error()== QtAudio::Error::NoError) {// 除了其他 start() 签名外，如果 // * 后端没有实现基于回调的 IO（所有主要 // 平台 都有该 API ） ，启动音频回调将失败 // * 音频回调的签名与 format.sampleFormat() 不匹配
        qWarning() << "Error starting audio output:" << audio->errorString();
    } }

void AudioOutputExample::handleStateChanged(QtAudio::State newState)
{
    switch (newState) {
        case QtAudio::IdleState:
            // Finished playing (no more data)
            AudioOutputExample::stopAudioOutput();
            break;

        case QtAudio::StoppedState:
            // Stopped for other reasons
            if (audio->error() != QtAudio::NoError) {
                // Error handling
            }
            break;

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

成员函数文档

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

构建新的音频输出并将其附加到parent 。默认音频输出设备与输出format 参数一起使用。如果format 被默认初始化，格式将被设置为音频设备的首选格式。

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

构建一个新的音频输出，并将其连接到parent 。由audioDevice 引用的设备与输出format 参数一起使用。如果format 已默认初始化，则格式将设置为audioDevice 的首选格式。

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

销毁此音频输出。

这将释放所有已使用的系统资源和缓冲区。

[since 6.10] qsizetype QAudioSink::bufferFrameCount() const

返回音频缓冲区的大小（以帧为单位）。

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

此函数在 Qt 6.10 中引入。

另请参阅 setBufferFrameCount() 和bufferSize 。

qsizetype QAudioSink::bufferSize() const

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

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

另请参阅 setBufferSize() 和bufferFrameCount 。

qsizetype QAudioSink::bytesFree() const

返回音频缓冲区中可用的空闲字节数。

另请参阅 framesFree 。

qint64 QAudioSink::elapsedUSecs() const

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

QtAudio::Error QAudioSink::error() const

返回错误状态。

QAudioFormat QAudioSink::format() const

返回正在使用的QAudioFormat 。

[since 6.10] qsizetype QAudioSink::framesFree() const

返回音频缓冲区中可用的空闲帧数。

此函数在 Qt 6.10 中引入。

另请参阅 bytesFree 。

bool QAudioSink::isNull() const

如果QAudioSink 实例是null ，则返回true ，否则返回false 。

qint64 QAudioSink::processedUSecs() const

返回调用start() 后处理的音频数据量（以微秒为单位）。

void QAudioSink::reset()

立即停止音频输出并丢弃当前缓冲区中的任何音频数据。推送到QIODevice 的所有待处理音频数据将被忽略。

另请参阅 stop() 。

void QAudioSink::resume()

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

将state() 设置为调用suspend() 时音频汇的状态。如果音频 sink 的状态不是QtAudio::SuspendedState ，则此函数不会执行任何操作。

[since 6.10] void QAudioSink::setBufferFrameCount(qsizetype value)

将音频缓冲区大小设置为value （以帧数为单位）。

此函数在 Qt 6.10 中引入。

另请参阅 bufferFrameCount() 和setBufferSize 。

void QAudioSink::setBufferSize(qsizetype value)

将音频缓冲区的大小设置为value ，单位为字节。

另请参阅 bufferSize() 和setBufferFrameCount 。

void QAudioSink::setVolume(qreal volume)

将输出音量设置为volume 。

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

默认音量为1.0 。

用户界面音量控制通常应以非线性方式缩放。例如，使用对数刻度将使感知响度产生线性变化，这正是用户通常期望从音量控制中获得的效果。更多详情，请参阅QtAudio::convertVolume() 。

另请参见 volume().

QIODevice *QAudioSink::start()

返回用于向系统音频输出传输数据的内部QIODevice 的指针。该设备已经打开，write() 可以直接向其写入数据。

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

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

另请参阅 QIODevice 和QIODevice interface 。

[since 6.11] template <typename Callback, QtAudio::if_audio_sink_callback<Callback> = true> void QAudioSink::start(Callback &&cb)

使用回调函数启动QAudioSink ，该函数将在软实时音频线程上调用。回调函数是一个可调用的函数，它将QSpan<SampleType> 作为参数，SampleType 必须与QAudioSink 的格式QAudioFormat::SampleFormat 匹配。跨度需要用交错音频数据填充。

如果QAudioSink 能够成功启动，error() 将返回QtAudio::NoError 。

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

此函数在 Qt 6.11 中引入。

另请参见 Callback interface 。

void QAudioSink::start(QIODevice *device)

开始将音频数据从device 传输到系统的音频输出端。device 必须在ReadOnly 或ReadWrite 模式下打开。

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

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

另请参阅 QIODevice 和QIODevice interface 。

QtAudio::State QAudioSink::state() const

返回音频处理的状态。

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

该信号在设备state 发生变化时发出。这是音频输出的当前状态。

void QAudioSink::stop()

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

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

另请参阅 reset().

void QAudioSink::suspend()

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

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

qreal QAudioSink::volume() const

返回介于 0.0 和 1.0 之间的体积。

另请参阅 setVolume()。