QAudioDecoder 类

成员函数文档

[显式] QAudioDecoder::QAudioDecoder(QObject *parent = nullptr)

使用 parent 构建一个 QAudioDecoder 实例。

[虚拟 noexcept] QAudioDecoder::~QAudioDecoder()

销毁音频解码器对象。

QAudioFormat QAudioDecoder::audioFormat() const

返回解码器设置到的音频格式。

另请参阅 setAudioFormat() 和 formatChanged。

bool QAudioDecoder::bufferAvailable() const

如果可用缓冲区以读取，则返回 true，否则返回 false。如果没有缓冲区可用，调用 read() 函数将返回一个无效的缓冲区。

[信号] void QAudioDecoder::bufferAvailableChanged(bool available)

指示新缓冲区的可用性（如果“可用”为真）。

如果“可用”为假，则没有可用缓冲区。

另请参阅 bufferAvailable() 和 bufferReady。

[signal] void QAudioDecoder::bufferReady()

表示新的解码音频缓冲区可供读取。

另请参阅 read() 和 bufferAvailable。

qint64 QAudioDecoder::duration() const

返回音频流的总体时长（以毫秒为单位），如果不可用则返回-1。

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

指示已解码数据估计的时长已更改。

另请参阅 positionChanged。

QAudioDecoder::Error QAudioDecoder::error() const

返回QAudioDecoder的当前错误状态。

[signal] void QAudioDecoder::error(QAudioDecoder::Error error)

表示出现错误情况。

注意：该类中信号error是重载的。要使用函数指针语法连接到此信号，Qt提供了一个方便的辅助程序来获取函数指针，例如

connect(audioDecoder, QOverload<QAudioDecoder::Error>::of(&QAudioDecoder::error),
    [=](QAudioDecoder::Error error){ /* ... */ });

另请参阅 errorString。

[signal] void QAudioDecoder::finished()

表示解码已完成。如果解码失败，则发出错误信号。

另请参阅 start，stop 和 error。

[signal] void QAudioDecoder::formatChanged(const QAudioFormat &format)

表示解码器当前的音频格式已更改为format。

另请参阅 audioFormat 和 setAudioFormat。

bool QAudioDecoder::isSupported() const

如果在此平台上支持音频解码，则返回true。

qint64 QAudioDecoder::position() const

返回从解码器读取的最后缓冲区的位置（以毫秒为单位）；如果没有读取缓冲区，则返回-1。

[signal] void QAudioDecoder::positionChanged(qint64 position)

指示解码器的当前位置position已更改。

另请参阅 durationChanged。

QAudioBuffer QAudioDecoder::read() const

从解码器中读取一个缓冲区，如果有的话。如果没有可用的已解码缓冲区或发生错误时，返回一个无效的缓冲区。在这两种情况下，此函数都不会阻塞。

您应该在调用read()之前响应bufferReady()信号或检查bufferAvailable()函数，以确保获取有用的数据。

void QAudioDecoder::setAudioFormat(const QAudioFormat &format)

将解码样本所需的音频格式设置为format。

只能在该解码器停止时设置此属性。在其他时候设置此属性将不被忽略。

如果解码器不支持此格式，error()将设置为FormatError。

如果您不指定格式，将使用解码音频本身的格式。否则，将应用一些格式转换。

如果您希望将解码格式重置为原始音频文件的格式，可以指定一个无效的format。

另请参阅：audioFormat。

void QAudioDecoder::setSource(const QUrl &fileName)

将当前音频文件名设置为fileName。

设置此属性时将停止任何当前解码，并丢弃任何音频缓冲区。

您只能指定源文件名或源QIODevice。设置其中之一将取消设置另一个。

另请参阅：source。

void QAudioDecoder::setSourceDevice(QIODevice *device)

将当前音频QIODevice设置为device。

设置此属性时将停止任何当前解码，并丢弃任何音频缓冲区。

您只能指定源文件名或源QIODevice。设置其中之一将取消设置另一个。

另请参阅：sourceDevice。

QUrl QAudioDecoder::source() const

返回要解码的当前文件名。如果调用了setSourceDevice，则将为空。

另请参阅：setSource。

[signal] void QAudioDecoder::sourceChanged()

表明解码器的当前源已更改。

另请参阅：source()和sourceDevice。

QIODevice *QAudioDecoder::sourceDevice() const

返回当前设置的源QIODevice，如果设置了的话。如果调用了setSource()，则将为null。

另请参阅：setSourceDevice。

[slot] void QAudioDecoder::start()

开始解码音频资源。

随着数据的解码，当解码足够的数据时，会发出 bufferReady() 信号。此时调用 read() 将返回一个音频缓冲区，而不会阻塞。

如果在缓冲区准备好之前调用 read()，则会返回一个无效的缓冲区，同样不会阻塞。

另请参阅read。

[slot] void QAudioDecoder::stop()

停止解码音频。再次调用 start() 会从开始重新开始解码。