QAudioFormat Class

成员函数文档

[implicit] QAudioFormat::QAudioFormat()

创建一种新的音频格式。

值的初始化如下：

• sampleRate() = 0
• channelCount() = 0
• sampleFormat() =QAudioFormat::Unknown

[implicit] QAudioFormat::QAudioFormat(const QAudioFormat &other)

使用other 构建一种新的音频格式。

[noexcept implicit] QAudioFormat::~QAudioFormat()

删除此音频格式。

qint32 QAudioFormat::bytesForDuration(qint64 microseconds) const

返回microseconds 中该音频格式所需的字节数。

如果该格式无效，则返回 0。

请注意，如果 `microseconds ` 不是 `sampleRate()` 的精确分数，可能会发生舍入误差。

另请参阅 durationForBytes()。

qint32 QAudioFormat::bytesForFrames(qint32 frameCount) const

返回此格式下frameCount 帧所需的字节数。

如果该格式无效，则返回 0。

另请参阅 bytesForDuration()。

[constexpr] int QAudioFormat::bytesPerFrame() const

返回以该格式表示一个帧（每个通道中的一个采样）所需的字节数。

如果该格式无效，则返回 0。

[constexpr noexcept] int QAudioFormat::bytesPerSample() const

返回以该格式表示一个采样所需的字节数。

如果此格式无效，则返回 0。

[constexpr noexcept] QAudioFormat::ChannelConfig QAudioFormat::channelConfig() const

返回当前通道配置。

另请参阅 setChannelConfig()。

[static constexpr] template <typename... Args> QAudioFormat::ChannelConfig QAudioFormat::channelConfig(Args... channels)

返回给定channels 的当前通道配置。

[constexpr noexcept] int QAudioFormat::channelCount() const

返回当前的通道数量值。

另请参阅 setChannelCount()。

[noexcept] int QAudioFormat::channelOffset(QAudioFormat::AudioChannelPosition channel) const

返回给定格式下音频帧中某个音频channel 的位置。如果该格式不存在该通道，或者通道配置未知，则返回-1。

[static] QAudioFormat::ChannelConfig QAudioFormat::defaultChannelConfigForChannelCount(int channelCount)

返回channelCount 的默认声道配置。

默认配置最多支持 8 个声道，分别对应标准的单声道、立体声和环绕声配置。对于更多声道的配置，该方法将直接使用在 `QAudioFormat::AudioChannelPosition` 中定义的首批 `channelCount ` 音频声道。

qint64 QAudioFormat::durationForBytes(qint32 bytes) const

返回bytes 在此格式下所表示的微秒数。

如果此格式无效，则返回 0。

请注意，如果 `bytes ` 不是每帧字节数的精确倍数，可能会发生舍入误差。

另请参阅 bytesForDuration()。

qint64 QAudioFormat::durationForFrames(qint32 frameCount) const

返回以该格式表示的frameCount 帧所对应的微秒数。

qint32 QAudioFormat::framesForBytes(qint32 byteCount) const

返回以该格式表示的、由 `byteCount ` 所代表的帧数。

请注意，如果 `byteCount ` 不是每帧字节数的精确倍数，可能会发生舍入误差。

每个帧中每个通道有一个采样点。

另请参阅 framesForDuration()。

qint32 QAudioFormat::framesForDuration(qint64 microseconds) const

返回以该格式表示microseconds 所需的帧数。

请注意，如果microseconds 不是sampleRate()的精确分数，可能会发生舍入误差。

[constexpr noexcept] bool QAudioFormat::isValid() const

如果所有参数均有效，则返回true 。

float QAudioFormat::normalizedSampleValue(const void *sample) const

将sample 的值归一化为-1到1之间的数值。该方法取决于QaudioFormat。

[constexpr noexcept] QAudioFormat::SampleFormat QAudioFormat::sampleFormat() const

返回当前的采样格式。

另请参阅 ` setSampleFormat()`。

[constexpr noexcept] int QAudioFormat::sampleRate() const

返回当前采样率（单位：赫兹）。

另请参阅 setSampleRate()。

[noexcept] void QAudioFormat::setChannelConfig(QAudioFormat::ChannelConfig config)

将声道配置设置为config 。

将音频格式的声道配置设置为标准音频声道配置之一。

另请参阅 channelConfig()。

[constexpr noexcept] void QAudioFormat::setChannelCount(int channels)

将通道数量设置为channels 。设置此选项也会将通道配置设置为ChannelConfigUnknown 。

另请参阅 channelCount()。

[constexpr noexcept] void QAudioFormat::setSampleFormat(QAudioFormat::SampleFormat format)

将采样格式设置为format 。

另请参阅 sampleFormat() 和QAudioFormat::SampleFormat 。

[constexpr noexcept] void QAudioFormat::setSampleRate(int samplerate)

将采样率设置为samplerate 赫兹。

另请参阅 sampleRate()。