QAudioDecoder Class

Documentación de funciones miembro

[explicit] QAudioDecoder::QAudioDecoder(QObject *parent = nullptr)

Construye una instancia de QAudioDecoder con parent.

[override virtual noexcept] QAudioDecoder::~QAudioDecoder()

Destruye el objeto decodificador de audio.

QAudioFormat QAudioDecoder::audioFormat() const

Devuelve el formato de audio al que está configurado el decodificador.

Véase también setAudioFormat() y formatChanged().

bool QAudioDecoder::bufferAvailable() const

Devuelve true si hay un buffer disponible para ser leído, y false en caso contrario. Si no hay ningún búfer disponible, la llamada a la función read() devolverá un búfer no válido.

[signal] void QAudioDecoder::bufferAvailableChanged(bool available)

Señala la disponibilidad (si available es verdadero) de un nuevo búfer.

Si available es falso, no hay buffers disponibles.

Véase también bufferAvailable() y bufferReady().

[signal] void QAudioDecoder::bufferReady()

Señala que un nuevo búfer de audio decodificado está disponible para ser leído.

Véase también read() y bufferAvailable().

qint64 QAudioDecoder::duration() const

Devuelve la duración total (en milisegundos) del flujo de audio o -1 si no está disponible.

[signal] void QAudioDecoder::durationChanged(qint64 duration)

Señala que la dirección duration estimada 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)

Señala que se ha producido una condición error.

// 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()

Señala que la descodificación ha finalizado correctamente. Si la descodificació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)

Señala que el formato de audio actual del descodificador ha cambiado a format.

Véase también audioFormat() y setAudioFormat().

bool QAudioDecoder::isSupported() const

Devuelve true si la decodificación de audio está soportada en esta plataforma.

qint64 QAudioDecoder::position() const

Devuelve la posición (en milisegundos) del último búfer leído del decodificador o -1 si no se ha leído ningún búfer.

[signal] void QAudioDecoder::positionChanged(qint64 position)

Señala que la dirección position actual del descodificador ha cambiado.

Véase también durationChanged().

QAudioBuffer QAudioDecoder::read() const

Lee un búfer del descodificador, si hay alguno disponible. Devuelve un búfer no válido si no hay búferes decodificados disponibles, o en caso de fallo. En ambos casos esta función no se bloqueará.

Deberías 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)

Establezca el formato de audio deseado para las muestras descodificadas en format.

Esta propiedad sólo puede establecerse mientras el decodificador está parado. Si se establece en otro momento, se ignorará.

Si el decodificador no admite este formato, error() se establecerá en FormatError.

Si no se especifica un formato, se utilizará el formato del propio audio decodificado. De lo contrario, se aplicará alguna conversión de formato.

Si desea restablecer el formato descodificado al del archivo de audio original, puede especificar un format no válido.

Véase también audioFormat().

void QAudioDecoder::setSource(const QUrl &fileName)

Establece el nombre del archivo de audio actual en fileName.

Cuando se establece esta propiedad, se detiene cualquier decodificación en curso y se descartan los búferes de audio.

Sólo se puede especificar un nombre de archivo fuente o una fuente QIODevice. Si se define uno, se desactiva el otro.

Véase también source().

void QAudioDecoder::setSourceDevice(QIODevice *device)

Establece el audio actual QIODevice a device.

Cuando se establece esta propiedad, se detiene cualquier decodificación en curso y se descartan los búferes de audio.

Sólo se puede especificar un nombre de archivo fuente o una fuente QIODevice. Si se define uno, se desactiva el otro.

Véase también sourceDevice().

QUrl QAudioDecoder::source() const

Devuelve el nombre del archivo actual a descodificar. Si se ha llamado a setSourceDevice, estará vacío.

Véase también setSource().

[signal] void QAudioDecoder::sourceChanged()

Señala que la fuente de corriente del decodificador ha cambiado.

Véase también source() y sourceDevice().

QIODevice *QAudioDecoder::sourceDevice() const

Devuelve la fuente actual QIODevice, si se estableció una. Si se llamó a setSource(), 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, la señal bufferReady() se emitirá cuando se hayan decodificado suficientes datos. La llamada a read() devolverá entonces un búfer de audio sin bloquearse.

Si se llama a read() antes de que el búfer esté listo, se devolverá un búfer no válido, también sin bloqueo.

Véase también read().

[slot] void QAudioDecoder::stop()

Detiene la decodificación de audio. Si vuelve a llamar a start(), se reanudará la descodificación desde el principio.