QAudioFormat 类

成员函数文档

[noexcept default] QAudioFormat::QAudioFormat()

构造一个新的音频格式。

值初始化如下

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

[noexcept default] QAudioFormat::QAudioFormat(const QAudioFormat &other)

使用other构造一个新的音频格式。

[noexcept default] 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。

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

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

另请参阅 setChannelConfig。

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

返回当前通道配置。

[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.