En esta página

QAudioBuffer Class

La clase QAudioBuffer representa un conjunto de muestras de audio con un formato y una frecuencia de muestreo específicos. Más información...

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

Tipos públicos

Funciones públicas

QAudioBuffer()
QAudioBuffer(const QByteArray &data, const QAudioFormat &format, qint64 startTime = -1)
QAudioBuffer(int numFrames, const QAudioFormat &format, qint64 startTime = -1)
QAudioBuffer(const QAudioBuffer &other)
QAudioBuffer(QAudioBuffer &&other)
~QAudioBuffer()
qsizetype byteCount() const
const T *constData() const
T *data()
const T *data() const
void detach()
qint64 duration() const
QAudioFormat format() const
qsizetype frameCount() const
bool isValid() const
qsizetype sampleCount() const
qint64 startTime() const
void swap(QAudioBuffer &other)
QAudioBuffer &operator=(QAudioBuffer &&other)
QAudioBuffer &operator=(const QAudioBuffer &other)

Descripción detallada

La clase ` QAudioDecoder ` utiliza `QAudioBuffer` para pasar los datos de audio descodificados a la aplicación. Un búfer de audio contiene datos en una determinada « QAudioFormat » que se puede consultar mediante ` format()`. También está etiquetado con información sobre la sincronización y la duración.

Para acceder a los datos almacenados en el búfer, utiliza los métodos data() o constData().

Los búferes de audio se comparten de forma explícita; en la mayoría de los casos, debes llamar a ` detach()` antes de modificar los datos.

Documentación sobre los tipos de miembros

QAudioBuffer::F32M

Se trata de una especialización predefinida para una muestra monofónica de 32 bits con precisión flotante.

QAudioBuffer::F32S

Se trata de una especialización predefinida para una muestra estéreo de 32 bits con precisión flotante.

QAudioBuffer::S16M

Se trata de una especialización predefinida para una muestra monofónica de 16 bits con signo. i

QAudioBuffer::S16S

Se trata de una especialización predefinida para una muestra estéreo de 16 bits con signo. Cada canal es un entero corto con signo.

QAudioBuffer::S32M

Se trata de una especialización predefinida para una muestra mono de 32 bits con signo.

QAudioBuffer::S32S

Se trata de una especialización predefinida para una muestra estéreo de 32 bits con signo.

QAudioBuffer::U8M

Se trata de una especialización predefinida para una muestra mono de 8 bits sin signo.

QAudioBuffer::U8S

Se trata de una especialización predefinida para una muestra estéreo de 8 bits sin signo.

Documentación de las funciones de miembro

[noexcept] QAudioBuffer::QAudioBuffer()

Crear un búfer nuevo, vacío e inválido.

QAudioBuffer::QAudioBuffer(const QByteArray &data, const QAudioFormat &format, qint64 startTime = -1)

Crea un nuevo búfer de audio a partir del ` data` proporcionado, en el ` format` indicado. El formato determinará cómo se interpretan el número y los tamaños de las muestras a partir del ` data`.

Si el ` data ` proporcionado no es un múltiplo entero del tamaño de trama calculado, los datos sobrantes no se utilizarán.

Este búfer de audio copiará el contenido de data.

startTime (en microsegundos) indica cuándo comienza este búfer en el flujo. Si este búfer no forma parte de un flujo, establécelo en -1.

QAudioBuffer::QAudioBuffer(int numFrames, const QAudioFormat &format, qint64 startTime = -1)

Crea un nuevo búfer de audio con capacidad para numFrames tramas del formato format especificado. Las muestras individuales se inicializarán con los valores predeterminados del formato.

startTime (en microsegundos) indica cuándo comienza este búfer en el flujo. Si este búfer no forma parte de un flujo, establécelo en -1.

[noexcept] QAudioBuffer::QAudioBuffer(const QAudioBuffer &other)

Crea un nuevo búfer de audio a partir de ` other`. Los búferes de audio se comparten de forma explícita, por lo que debes llamar a ` detach()` en el búfer para crear una copia que luego pueda modificarse.

[constexpr noexcept default] QAudioBuffer::QAudioBuffer(QAudioBuffer &&other)

Crea un QAudioBuffer a partir de other.

[noexcept] QAudioBuffer::~QAudioBuffer()

Elimina este búfer de audio.

[noexcept] qsizetype QAudioBuffer::byteCount() const

Devuelve el tamaño de este búfer, en bytes.

template <typename T> const T *QAudioBuffer::constData() const

Devuelve un puntero a los datos de este búfer. Solo se puede leer.

Se recomienda utilizar este método en lugar de la versión const de data() para evitar copias innecesarias.

Ten en cuenta que no se comprueba el formato del búfer de audio; se trata simplemente de una función de conveniencia.

// With a 16bit sample buffer:
const quint16 *data = buffer->constData<quint16>();

template <typename T> T *QAudioBuffer::data()

Devuelve un puntero a los datos de este búfer. Puedes modificar los datos a través del puntero devuelto.

Dado que los objetos de tipo ` QAudioBuffer ` se comparten explícitamente, por lo general se debe llamar a ` detach()` antes de modificar los datos mediante esta función.

Ten en cuenta que no se comprueba el formato del búfer de audio; se trata simplemente de una función de conveniencia.

// With a 16bit sample buffer:
quint16 *data = buffer->data<quint16>(); // May cause deep copy

template <typename T> const T *QAudioBuffer::data() const

Devuelve un puntero a los datos de este búfer. Solo se puede leer.

Se recomienda utilizar la función ` constData()` en lugar de esta para evitar copias profundas accidentales.

Ten en cuenta que no se comprueba el formato del búfer de audio; se trata simplemente de una función de conveniencia.

// With a 16bit sample const buffer:
const quint16 *data = buffer->data<quint16>();

void QAudioBuffer::detach()

Separa este búfer de audio de otras copias que pudieran compartir datos con él.

[noexcept] qint64 QAudioBuffer::duration() const

Devuelve la duración del audio de este búfer, en microsegundos.

Esto depende de la función « format()» y de la función « frameCount()».

[noexcept] QAudioFormat QAudioBuffer::format() const

Devuelve el valor « format » de este búfer.

Varias propiedades de este formato influyen en cómo se calculan las funciones « duration()» o « byteCount()» a partir de « frameCount()».

[noexcept] qsizetype QAudioBuffer::frameCount() const

Devuelve el número de tramas de audio completas que hay en este búfer.

Una trama de audio es un conjunto entrelazado de una muestra por canal correspondiente al mismo instante de tiempo.

[noexcept] bool QAudioBuffer::isValid() const

Devuelve «true» si se trata de un búfer válido. Un búfer válido contiene más de cero fotogramas y tiene un formato válido.

[noexcept] qsizetype QAudioBuffer::sampleCount() const

Devuelve el número de muestras de este búfer.

Si el formato de este búfer tiene varios canales, este recuento incluye todos los canales. Esto significa que un búfer estéreo con un total de 1000 muestras tendrá 500 muestras izquierdas y 500 muestras derechas (entrelazadas), y esta función devolverá 1000.

Véase también frameCount().

[noexcept] qint64 QAudioBuffer::startTime() const

Devuelve el momento en un flujo en el que comienza este búfer (en microsegundos).

Si este búfer no forma parte de un flujo, se devolverá -1.

[noexcept] void QAudioBuffer::swap(QAudioBuffer &other)

Intercambia el búfer de audio con « other ».

[noexcept] QAudioBuffer &QAudioBuffer::operator=(QAudioBuffer &&other)

Traslada « other » a esta dirección: QAudioBuffer.

QAudioBuffer &QAudioBuffer::operator=(const QAudioBuffer &other)

Asigna el búfer de « other » a esto.

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