QAudioFormat Class

成员函数文档

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

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