QAudioDecoder Class
La clase QAudioDecoder se encarga de la decodificación de audio. Más información...
| Encabezado: | #include <QAudioDecoder> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| Heredado de: | QObject |
| Estado: | Versión preliminar |
Esta clase se encuentra en fase de vista previa tecnológica y está sujeta a cambios.
Tipos públicos
| enum | Error { NoError, ResourceError, FormatError, AccessDeniedError, NotSupportedError } |
Propiedades
- bufferAvailable : bool
- error : QString
- isDecoding : bool
- source : QUrl
Funciones públicas
| QAudioDecoder(QObject *parent = nullptr) | |
| virtual | ~QAudioDecoder() override |
| QAudioFormat | audioFormat() const |
| bool | bufferAvailable() const |
| qint64 | duration() const |
| QAudioDecoder::Error | error() const |
| QString | errorString() const |
| bool | isDecoding() const |
| bool | isSupported() const |
| qint64 | position() const |
| QAudioBuffer | read() const |
| void | setAudioFormat(const QAudioFormat &format) |
| void | setSource(const QUrl &fileName) |
| void | setSourceDevice(QIODevice *device) |
| QUrl | source() const |
| QIODevice * | sourceDevice() const |
Ranuras públicas
Señales
| void | bufferAvailableChanged(bool available) |
| void | bufferReady() |
| void | durationChanged(qint64 duration) |
| void | error(QAudioDecoder::Error error) |
| void | finished() |
| void | formatChanged(const QAudioFormat &format) |
| void | isDecodingChanged(bool) |
| void | positionChanged(qint64 position) |
| void | sourceChanged() |
Descripción detallada
La clase QAudioDecoder es una clase de alto nivel para decodificar archivos multimedia de audio. Es similar a la clase QMediaPlayer, salvo que el audio se devuelve a través de esta API en lugar de enviarse directamente al hardware de audio.
Véase también QAudioBuffer.
Documentación sobre los tipos de miembros
enum QAudioDecoder::Error
Define una condición de error del reproductor multimedia.
| Constante | Valor | Descripción |
|---|---|---|
QAudioDecoder::NoError | 0 | No se ha producido ningún error. |
QAudioDecoder::ResourceError | 1 | No se ha podido resolver un recurso multimedia. |
QAudioDecoder::FormatError | 2 | El formato de un recurso multimedia no es compatible. |
QAudioDecoder::AccessDeniedError | 3 | No se dispone de los permisos adecuados para reproducir un recurso multimedia. |
QAudioDecoder::NotSupportedError | 4 | QAudioDecoder No es compatible con esta plataforma |
Documentación de propiedades
[read-only] bufferAvailable : bool
Esta propiedad indica si hay un búfer de audio descodificado disponible
Funciones de acceso:
| bool | bufferAvailable() const |
Señal de notificación:
| void | bufferAvailableChanged(bool available) |
[read-only] error : QString
Devuelve una descripción comprensible del error actual o una cadena vacía si no hay ningún error.
Funciones de acceso:
| QString | errorString() const |
[read-only] isDecoding : bool
true si el decodificador está en funcionamiento y decodificando datos de audio.
Funciones de acceso:
| bool | isDecoding() const |
Señal de notificación:
| void | isDecodingChanged(bool) |
source : QUrl
Esta propiedad contiene el nombre del archivo activo que está siendo descodificado por el objeto descodificador.
Funciones de acceso:
Señal de notificación:
| void | sourceChanged() |
Documentación de las funciones de miembro
[explicit] QAudioDecoder::QAudioDecoder(QObject *parent = nullptr)
Crea una instancia de QAudioDecoder con ` parent`.
[override virtual noexcept] QAudioDecoder::~QAudioDecoder()
Elimina el objeto decodificador de audio.
QAudioFormat QAudioDecoder::audioFormat() const
Devuelve el formato de audio en el que está configurado el decodificador.
Nota: Esto puede diferir del formato de las muestras decodificadas si el formato de audio se ha configurado en uno no válido.
Véase también setAudioFormat() y formatChanged().
bool QAudioDecoder::bufferAvailable() const
Devuelve «true» si hay un búfer disponible para su lectura y «false» en caso contrario. Si no hay ningún búfer disponible, al llamar a la función ` read()` se devolverá un búfer no válido.
Nota: Funcióngetter para la propiedad bufferAvailable.
[signal] void QAudioDecoder::bufferAvailableChanged(bool available)
Indica la disponibilidad (si « available » es «true») de un nuevo búfer.
Si available es falso, no hay búferes disponibles.
Nota: Señalde notificador para la propiedad ` bufferAvailable`.
Véase también ` bufferAvailable()` y ` bufferReady()`.
[signal] void QAudioDecoder::bufferReady()
Indica que hay un nuevo búfer de audio descodificado disponible para su lectura.
Véase también read() y bufferAvailable().
qint64 QAudioDecoder::duration() const
Devuelve la duración total (en milisegundos) de la secuencia de audio o -1 si no está disponible.
[signal] void QAudioDecoder::durationChanged(qint64 duration)
Indica que el valor estimado de « duration » de los datos descodificados ha cambiado.
Véase también positionChanged().
QAudioDecoder::Error QAudioDecoder::error() const
Devuelve el estado de error actual de ` QAudioDecoder`.
[signal] void QAudioDecoder::error(QAudioDecoder::Error error)
Indica que se ha producido una condición de « error ».
Nota: Esta señal está sobrecargada. Para conectarse a esta señal:
// Connect using qOverload:
connect(audioDecoder, qOverload(&QAudioDecoder::error),
receiver, &ReceiverClass::slot);
// Or using a lambda:
connect(audioDecoder, qOverload(&QAudioDecoder::error),
this, [](QAudioDecoder::Error error) { /* handle error */ }); Véase también ` errorString()`.
[signal] void QAudioDecoder::finished()
Indica que la decodificación se ha completado correctamente. Si la decodificación falla, se emite una señal de error en su lugar.
Véase también start(), stop() y error().
[signal] void QAudioDecoder::formatChanged(const QAudioFormat &format)
Indica que el formato de audio actual del decodificador ha cambiado a format.
Véase también audioFormat() y setAudioFormat().
bool QAudioDecoder::isSupported() const
Devuelve «true» si esta plataforma admite la decodificación de audio.
qint64 QAudioDecoder::position() const
Devuelve la posición (en milisegundos) del último búfer leído desde el decodificador o -1 si no se ha leído ningún búfer.
[signal] void QAudioDecoder::positionChanged(qint64 position)
Indica que el position actual del descodificador ha cambiado.
Véase también durationChanged().
QAudioBuffer QAudioDecoder::read() const
Lee un búfer del decodificador, si hay alguno disponible. Devuelve un búfer no válido si no hay ningún búfer decodificado disponible en ese momento, o en caso de error. En ambos casos, esta función no se bloqueará.
Debes responder a la señal « bufferReady()» o comprobar la función « bufferAvailable()» antes de llamar a «read()» para asegurarte de que obtienes datos útiles.
void QAudioDecoder::setAudioFormat(const QAudioFormat &format)
Establece el formato de audio deseado para las muestras descodificadas en « format ».
Esta propiedad solo se puede configurar mientras el decodificador está detenido. Si se configura en cualquier otro momento, se ignorará.
Si el decodificador no admite este formato, error() se establecerá en FormatError.
Si no se especifica ningún formato, se utilizará el formato del propio audio decodificado. De lo contrario, se aplicará alguna conversión de formato.
Si deseas restablecer el formato decodificado al del archivo de audio original, puedes especificar un format no válido.
Advertencia: la configuración del formato de audio deseado aún no es compatible con el backend de Android. Sí funciona con el backend predeterminado de FFMPEG.
Véase también audioFormat().
void QAudioDecoder::setSource(const QUrl &fileName)
Establece el nombre del archivo de audio actual como « fileName ».
Cuando se establece esta propiedad, se detiene cualquier decodificación en curso y se descartan los búferes de audio.
Solo se puede especificar o bien un nombre de archivo de origen o bien una dirección de origen QIODevice. Al establecer uno, se desactiva el otro.
Nota: Funciónde establecimiento para la propiedad source.
Véase también source().
void QAudioDecoder::setSourceDevice(QIODevice *device)
Establece el « QIODevice » de audio actual en « device ».
Cuando se establece esta propiedad, se detiene cualquier decodificación en curso y se descartan los búferes de audio.
Solo se puede especificar o bien un nombre de archivo de origen o bien un QIODevice de origen. Al establecer uno, se desactiva el otro.
Véase también sourceDevice().
QUrl QAudioDecoder::source() const
Devuelve el nombre del archivo actual que se va a decodificar. Si se ha llamado a la función « setSourceDevice », este valor estará vacío.
Nota: Funcióngetter para la propiedad source.
Véase también setSource().
[signal] void QAudioDecoder::sourceChanged()
Indica que ha cambiado la fuente de corriente del decodificador.
Nota: Señalde notificación para la propiedad source.
Véase también source() y sourceDevice().
QIODevice *QAudioDecoder::sourceDevice() const
Devuelve la fuente actual ` QIODevice`, si se ha establecido alguna. Si se ha llamado a ` setSource()`, este valor será un `nullptr`.
Véase también setSourceDevice().
[slot] void QAudioDecoder::start()
Inicia la decodificación del recurso de audio.
A medida que se decodifican los datos, se emitirá la señal « bufferReady()» cuando se haya decodificado una cantidad suficiente de datos. Al llamar a « read()», se devolverá un búfer de audio sin bloqueo.
Si se llama a ` read()` antes de que el búfer esté listo, se devolverá un búfer no válido, de nuevo sin bloqueo.
Véase también read().
[slot] void QAudioDecoder::stop()
Detener la decodificación de audio. Si se vuelve a llamar a start(), se reanudará la decodificación desde el principio.
© 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.