En esta página

QAudioFormat Class

La clase QAudioFormat almacena información sobre los parámetros de los flujos de audio. Más información...

Encabezado: #include <QAudioFormat>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia

Tipos públicos

enum AudioChannelPosition { UnknownPosition, FrontLeft, FrontRight, FrontCenter, LFE, …, BottomFrontRight }
enum ChannelConfig { ChannelConfigUnknown, ChannelConfigMono, ChannelConfigStereo, ChannelConfig2Dot1, ChannelConfig3Dot0, …, ChannelConfigSurround7Dot1 }
enum SampleFormat { Unknown, UInt8, Int16, Int32, Float }

Funciones públicas

QAudioFormat()
QAudioFormat(const QAudioFormat &other)
~QAudioFormat()
qint32 bytesForDuration(qint64 microseconds) const
qint32 bytesForFrames(qint32 frameCount) const
int bytesPerFrame() const
int bytesPerSample() const
QAudioFormat::ChannelConfig channelConfig() const
int channelCount() const
int channelOffset(QAudioFormat::AudioChannelPosition channel) const
qint64 durationForBytes(qint32 bytes) const
qint64 durationForFrames(qint32 frameCount) const
qint32 framesForBytes(qint32 byteCount) const
qint32 framesForDuration(qint64 microseconds) const
bool isValid() const
float normalizedSampleValue(const void *sample) const
QAudioFormat::SampleFormat sampleFormat() const
int sampleRate() const
void setChannelConfig(QAudioFormat::ChannelConfig config)
void setChannelCount(int channels)
void setSampleFormat(QAudioFormat::SampleFormat format)
void setSampleRate(int samplerate)

Miembros públicos estáticos

QAudioFormat::ChannelConfig channelConfig(Args... channels)
QAudioFormat::ChannelConfig defaultChannelConfigForChannelCount(int channelCount)
bool operator!=(const QAudioFormat &a, const QAudioFormat &b)
bool operator==(const QAudioFormat &a, const QAudioFormat &b)

Descripción detallada

Un formato de audio especifica cómo se organizan los datos en un flujo de audio sin procesar. Por ejemplo, cómo debe interpretarse el flujo.

QAudioFormat contiene parámetros que especifican cómo se organizan los datos de las muestras de audio. Estos son la frecuencia, el número de canales y el formato de muestra. La siguiente tabla los describe con más detalle.

ParámetroDescripción
Frecuencia de muestreoMuestras por segundo de datos de audio en hercios.
Número de canalesEl número de canales de audio (normalmente uno para mono o dos para estéreo). Se trata de la cantidad de muestras consecutivas que, en conjunto, forman un fotograma en el flujo
Formato de muestraEl formato de las muestras de audio en el flujo

Esta clase se utiliza junto con QAudioSource o QAudioSink para permitirte especificar los parámetros del flujo de audio que se está leyendo o escribiendo, o con QAudioBuffer cuando se trabaja con muestras en memoria.

Puede obtener los formatos de audio compatibles con el dispositivo de audio utilizado a través de las funciones de QAudioDevice. Esta clase también le permite consultar los valores de los parámetros disponibles para un dispositivo, de modo que pueda configurar los parámetros usted mismo. Consulte la descripción de la clase QAudioDevice para obtener más detalles. Debe conocer el formato de los flujos de audio que desea reproducir o grabar.

Las muestras de todos los canales se entrelazarán. En Qt Multimedia (y en otros lugares), se denomina «trama» a una muestra de cada canal correspondiente a un mismo instante de tiempo.

Documentación sobre los tipos de miembro

enum QAudioFormat::AudioChannelPosition

Describe las posibles posiciones de los canales de audio. Estas se ajustan a la definición estándar utilizada en la configuración de sonido envolvente 22.2.

ConstanteValorDescripción
QAudioFormat::UnknownPosition0Posición desconocida
QAudioFormat::FrontLeft1 
QAudioFormat::FrontRight2 
QAudioFormat::FrontCenter3 
QAudioFormat::LFE4Canal de efectos de baja frecuencia (subwoofer)
QAudioFormat::BackLeft5 
QAudioFormat::BackRight6 
QAudioFormat::FrontLeftOfCenter7 
QAudioFormat::FrontRightOfCenter8 
QAudioFormat::BackCenter9 
QAudioFormat::LFE219 
QAudioFormat::SideLeft10 
QAudioFormat::SideRight11 
QAudioFormat::TopFrontLeft13 
QAudioFormat::TopFrontRight15 
QAudioFormat::TopFrontCenter14 
QAudioFormat::TopCenter12 
QAudioFormat::TopBackLeft16 
QAudioFormat::TopBackRight18 
QAudioFormat::TopSideLeft20 
QAudioFormat::TopSideRight21 
QAudioFormat::TopBackCenter17 
QAudioFormat::BottomFrontCenter22 
QAudioFormat::BottomFrontLeft23 
QAudioFormat::BottomFrontRight24 

enum QAudioFormat::ChannelConfig

Esta enumeración describe una disposición estandarizada de los canales de audio. Las configuraciones más habituales son las configuraciones mono, estéreo, 2.1 (estéreo más baja frecuencia), sonido envolvente 5.1 y sonido envolvente 7.1.

ConstanteValorDescripción
QAudioFormat::ChannelConfigUnknown0Se desconoce la configuración de canales.
QAudioFormat::ChannelConfigMonoQtPrivate::channelConfig(FrontCenter)El audio tiene un canal central.
QAudioFormat::ChannelConfigStereoQtPrivate::channelConfig(FrontLeft, FrontRight)El audio tiene dos canales: izquierdo y derecho.
QAudioFormat::ChannelConfig2Dot1QtPrivate::channelConfig(FrontLeft, FrontRight, LFE)El audio tiene tres canales: izquierdo, derecho y LFE (efecto de baja frecuencia).
QAudioFormat::ChannelConfig3Dot0QtPrivate::channelConfig(FrontLeft, FrontRight, FrontCenter)El audio tiene tres canales: izquierdo, derecho y central.
QAudioFormat::ChannelConfig3Dot1QtPrivate::channelConfig(FrontLeft, FrontRight, FrontCenter, LFE)El audio tiene cuatro canales: izquierdo, derecho, central y LFE (efecto de baja frecuencia).
QAudioFormat::ChannelConfigSurround5Dot0QtPrivate::channelConfig(FrontLeft, FrontRight, FrontCenter, BackLeft, BackRight)El audio tiene cinco canales: izquierdo, derecho, central, « BackLeft » y « BackRight ».
QAudioFormat::ChannelConfigSurround5Dot1QtPrivate::channelConfig(FrontLeft, FrontRight, FrontCenter, LFE, BackLeft, BackRight)El audio tiene 6 canales: izquierdo, derecho, central, LFE, « BackLeft » y « BackRight ».
QAudioFormat::ChannelConfigSurround7Dot0QtPrivate::channelConfig(FrontLeft, FrontRight, FrontCenter, BackLeft, BackRight, SideLeft, SideRight)El audio tiene 7 canales: izquierdo, derecho, central, BackLeft, BackRight, SideLeft y SideRight.
QAudioFormat::ChannelConfigSurround7Dot1QtPrivate::channelConfig(FrontLeft, FrontRight, FrontCenter, LFE, BackLeft, BackRight, SideLeft, SideRight)El audio tiene 8 canales: izquierdo, derecho, central, LFE, BackLeft, BackRight, SideLeft y SideRight.

enum QAudioFormat::SampleFormat

Qt siempre esperará y utilizará muestras con el orden de bytes (endianness) de la plataforma de acogida. Cuando proceses por tu cuenta datos de audio procedentes de fuentes externas, asegúrate de convertirlos al orden de bytes correcto antes de escribirlos en un ` QAudioSink ` o ` QAudioBuffer`.

ConstanteValorDescripción
QAudioFormat::Unknown0Sin definir
QAudioFormat::UInt81Las muestras son enteros sin signo de 8 bits
QAudioFormat::Int162Las muestras son enteros con signo de 16 bits
QAudioFormat::Int323Las muestras son enteros con signo de 32 bits
QAudioFormat::Float4Las muestras son números de coma flotante

Documentación de las funciones de miembro

[implicit] QAudioFormat::QAudioFormat()

Crea un nuevo formato de audio.

Los valores se inicializan de la siguiente manera:

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

Crea un nuevo formato de audio utilizando other.

[noexcept implicit] QAudioFormat::~QAudioFormat()

Elimina este formato de audio.

qint32 QAudioFormat::bytesForDuration(qint64 microseconds) const

Devuelve el número de bytes necesarios para este formato de audio en microseconds.

Devuelve 0 si este formato no es válido.

Ten en cuenta que puede producirse algún redondeo si microseconds no es una fracción exacta de sampleRate().

Véase también durationForBytes().

qint32 QAudioFormat::bytesForFrames(qint32 frameCount) const

Devuelve el número de bytes necesarios para un frameCount s de tramas de este formato.

Devuelve 0 si este formato no es válido.

Véase también bytesForDuration().

[constexpr] int QAudioFormat::bytesPerFrame() const

Devuelve el número de bytes necesarios para representar una trama (una muestra en cada canal) en este formato.

Devuelve 0 si este formato no es válido.

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

Devuelve el número de bytes necesarios para representar una muestra en este formato.

Devuelve 0 si este formato no es válido.

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

Devuelve la configuración actual del canal.

Véase también ` setChannelConfig()`.

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

Devuelve la configuración actual del canal para el objeto ` channels` indicado.

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

Devuelve el valor actual del número de canales.

Véase también setChannelCount().

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

Devuelve la posición de un canal de audio determinado ( channel ) dentro de una trama de audio para el formato indicado. Devuelve -1 si el canal no existe para este formato o si se desconoce la configuración del canal.

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

Devuelve una configuración de canales predeterminada para channelCount.

Las configuraciones predeterminadas se definen para un máximo de 8 canales y se corresponden con las configuraciones estándar mono, estéreo y surround. Para un número mayor de canales, simplemente se utilizan los primeros canales de audio de channelCount definidos en QAudioFormat::AudioChannelPosition.

qint64 QAudioFormat::durationForBytes(qint32 bytes) const

Devuelve el número de microsegundos que representa bytes en este formato.

Devuelve 0 si este formato no es válido.

Ten en cuenta que puede producirse algún redondeo si bytes no es un múltiplo exacto del número de bytes por trama.

Véase también bytesForDuration().

qint64 QAudioFormat::durationForFrames(qint32 frameCount) const

Devuelve el número de microsegundos que representan las tramas de « frameCount » en este formato.

qint32 QAudioFormat::framesForBytes(qint32 byteCount) const

Devuelve el número de tramas que representa byteCount en este formato.

Ten en cuenta que puede producirse algún redondeo si byteCount no es un múltiplo exacto del número de bytes por trama.

Cada trama tiene una muestra por canal.

Véase también framesForDuration().

qint32 QAudioFormat::framesForDuration(qint64 microseconds) const

Devuelve el número de fotogramas necesarios para representar microseconds en este formato.

Ten en cuenta que puede producirse algún redondeo si microseconds no es una fracción exacta de sampleRate().

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

Devuelve « true » si todos los parámetros son válidos.

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

Normaliza el valor de « sample » a un número comprendido entre -1 y 1. El método depende del QaudioFormat.

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

Devuelve el formato de muestra actual.

Véase también setSampleFormat().

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

Devuelve la frecuencia de muestreo actual en hercios.

Véase también setSampleRate().

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

Establece la configuración de canales en « config ».

Establece la configuración de canales del formato de audio en una de las configuraciones estándar de canales de audio.

Nota: esto también modificará el número de canales.

Véase también channelConfig().

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

Establece el número de canales en channels. Al establecer este valor, también se configura la configuración de los canales en ChannelConfigUnknown.

Véase también channelCount().

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

Establece el formato de muestra en « format ».

Véase también ` sampleFormat()` y ` QAudioFormat::SampleFormat`.

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

Establece la frecuencia de muestreo en samplerate en hercios.

Véase también sampleRate().

Funciones relacionadas para usuarios no registrados

bool operator!=(const QAudioFormat &a, const QAudioFormat &b)

Devuelve « true » si el formato de audio « a » no es igual a « b »; en caso contrario, devuelve « false ».

bool operator==(const QAudioFormat &a, const QAudioFormat &b)

Devuelve « true » si el formato de audio « a » es igual a « b »; en caso contrario, devuelve « false ».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.