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