QAudioSink Class

QFile sourceFile; // miembro de la clase.QAudioSink* sourceFile.setFileName("/tmp/test.raw"); sourceFile.open(QIODevice::ReadOnly);    QAudioFormat format; // Configura el formato, por ejemploformat.setSampleRate(44100); format.setChannelCount(1); format.setSampleFormat(QAudioFormat::Int16);    QAudioDevice info(QMediaDevices::defaultAudioOutput()); if (!info.isFormatSupported(format)) {        qWarning() << "Raw audio format not supported by backend, cannot play audio.";
       return; } audio = new QAudioSink(format, this); connect(audio, QAudioSink::stateChanged, this, &AudioInputExample::handleStateChanged);  audio->start(&sourceFile); }

void AudioOutputExample::stopAudioOutput()
{
    audio->stop();
    sourceFile.close();
    delete audio;
}

QAudioSink* audio; // Miembro de la clase.float phase; // Miembro de la clase.{ QAudioFormat format; // Configura el formato, ej.format.setSampleRate(44100); format.setChannelCount(2); format.setSampleFormat(QAudioFormat::Float);    QAudioDevice info(QMediaDevices::defaultAudioOutput()); if (!info.isFormatSupported(format)) {        qWarning() << "Raw audio format not supported by backend, cannot play audio.";
       return; } audio = new QAudioSink(format, this); float phaseIncrement = 2 * M_PI * 220.0 / format.sampleRate(); // onda sinusoidal de 220 Hz audio->start([&phase, phaseIncrement] (QSpan<float> interleavedAudioBuffer) { // La llamada de retorno de audio no debe llamar a ninguna función que pueda estar potencialmente bloqueando // Llenar el buffer de audio con una onda sinusoidal const int sampleCount = interleavedAudioBuffer.¡size() / 2; // Estéreo, así que divide por 2 for(int i = 0; i < sampleCount; ++i) { float sample = std::sin(phase); interleavedAudioBuffer[i * 2] = sample; // Canal izquierdointerleavedAudioBuffer[i * 2 + 1] = sample; // Canal derechophase += phaseIncrement; // Incrementa la fase para la siguiente muestra} }); if (!audio->error() == QtAudio::Error::NoError) { // además de las otras firmas de start(), iniciar la  callback  de audio fallará si // * el backend no implementa IO basado en callback (la API está disponible en todas las //  principales  plataformas) // * la firma de la callback de audio no coincide con format.sampleFormat()
        qWarning() << "Error starting audio output:" << audio->errorString();
    } }

void AudioOutputExample::handleStateChanged(QtAudio::State newState)
{
    switch (newState) {
        case QtAudio::IdleState:
            // Finished playing (no more data)
            AudioOutputExample::stopAudioOutput();
            break;

        case QtAudio::StoppedState:
            // Stopped for other reasons
            if (audio->error() != QtAudio::NoError) {
                // Error handling
            }
            break;

        default:
            // ... other cases as appropriate
            break;
    }
}

Documentación de las funciones miembro

[explicit] QAudioSink::QAudioSink(const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

Construye una nueva salida de audio y adjúntala a parent. El dispositivo de salida de audio por defecto se utiliza con los parámetros de salida format. Si format se inicializa por defecto, el formato se ajustará al formato preferido del dispositivo de audio.

[explicit] QAudioSink::QAudioSink(const QAudioDevice &audioDevice, const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

Construye una nueva salida de audio y adjúntala a parent. El dispositivo referenciado por audioDevice se utiliza con los parámetros de salida format. Si format se inicializa por defecto, el formato se ajustará al formato preferido de audioDevice.

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

Destruye esta salida de audio.

Esto liberará cualquier recurso del sistema utilizado y liberará cualquier búfer.

[since 6.10] qsizetype QAudioSink::bufferFrameCount() const

Devuelve el tamaño del búfer de audio en fotogramas.

Si se llama antes de start(), devuelve el valor predeterminado de la plataforma. Si se llama antes de start() pero antes se ha llamado a setBufferSize() o setBufferFrameCount() , devuelve el valor establecido por setBufferSize() o setBufferFrameCount(). Si se llama después de start(), devuelve el tamaño real del búfer que se está utilizando. Este puede no ser el que fue establecido previamente por setBufferSize() o setBufferFrameCount().

Esta función se introdujo en Qt 6.10.

Véase también setBufferFrameCount() y bufferSize.

qsizetype QAudioSink::bufferSize() const

Devuelve el tamaño del búfer de audio en bytes.

Si se llama antes de start(), devuelve el valor predeterminado de la plataforma. Si se llama antes de start() pero antes se ha llamado a setBufferSize() o setBufferFrameCount() , devuelve el valor establecido por setBufferSize() o setBufferFrameCount(). Si se llama después de start(), devuelve el tamaño real del búfer que se está utilizando. Este puede no ser el que se estableció previamente en setBufferSize() o setBufferFrameCount().

Véase también setBufferSize() y bufferFrameCount.

qsizetype QAudioSink::bytesFree() const

Devuelve el número de bytes libres disponibles en el buffer de audio.

Véase también framesFree.

qint64 QAudioSink::elapsedUSecs() const

Devuelve los microsegundos transcurridos desde que se llamó a start(), incluido el tiempo en los estados inactivo y suspendido.

QtAudio::Error QAudioSink::error() const

Devuelve el estado de error.

QAudioFormat QAudioSink::format() const

Devuelve la dirección QAudioFormat que se está utilizando.

[since 6.10] qsizetype QAudioSink::framesFree() const

Devuelve el número de fotogramas libres disponibles en el búfer de audio.

Esta función se introdujo en Qt 6.10.

Véase también bytesFree.

bool QAudioSink::isNull() const

Devuelve true si la instancia QAudioSink es null, en caso contrario devuelve false.

qint64 QAudioSink::processedUSecs() const

Devuelve la cantidad de datos de audio procesados desde que se llamó a start() (en microsegundos).

void QAudioSink::reset()

Detiene inmediatamente la salida de audio y descarta cualquier dato de audio actualmente en los búferes. Todos los datos de audio pendientes enviados a QIODevice son ignorados.

Véase también stop().

void QAudioSink::resume()

Reanuda el procesamiento de datos de audio tras una llamada a suspend().

Establece state() al estado que tenía el sumidero cuando se llamó a suspend(). Esta función no hace nada si el estado del sumidero de audio no es QtAudio::SuspendedState().

[since 6.10] void QAudioSink::setBufferFrameCount(qsizetype value)

Establece el tamaño del búfer de audio en value en número de fotogramas.

Esta función se introdujo en Qt 6.10.

Véase también bufferFrameCount() y setBufferSize.

void QAudioSink::setBufferSize(qsizetype value)

Establece el tamaño del búfer de audio en value en bytes.

Véase también bufferSize() y setBufferFrameCount.

void QAudioSink::setVolume(qreal volume)

Establece el volumen de salida en volume.

El volumen se escala linealmente de 0.0 (silencio) a 1.0 (volumen máximo). Los valores que queden fuera de este rango se bloquearán.

El volumen por defecto es 1.0.

Por lo general, los controles de volumen de la interfaz de usuario deben escalarse de forma no lineal. Por ejemplo, usar una escala logarítmica producirá cambios lineales en el volumen percibido, que es lo que un usuario esperaría normalmente de un control de volumen. Para más información, consulte QtAudio::convertVolume().

Véase también volume().

QIODevice *QAudioSink::start()

Devuelve un puntero al QIODevice interno que se está utilizando para transferir datos a la salida de audio del sistema. El dispositivo ya estará abierto y write() puede escribir datos directamente en él.

Si QAudioSink puede acceder al dispositivo de audio del sistema, state() devuelve QtAudio::IdleState, error() devuelve QtAudio::NoError y se emite la señal stateChanged().

Si se produce un problema durante este proceso, error() devuelve QtAudio::OpenError, state() devuelve QtAudio::StoppedState y se emite la señal stateChanged().

Véase también QIODevice y QIODevice interface.

[since 6.11] template <typename Callback, QtAudio::if_audio_sink_callback<Callback> = true> void QAudioSink::start(Callback &&cb)

Inicia el QAudioSink con una función callback que será llamada en un hilo de audio soft-realtime. El callback es un callable que toma un QSpan<SampleType> como argumento, SampleType tiene que coincidir con el QAudioFormat::SampleFormat del QAudioSink's formato. El intervalo debe llenarse con datos de audio intercalados.

Si QAudioSink se inicia correctamente, error() devuelve QtAudio::NoError.

Si se produce un problema durante este proceso, error() devuelve QtAudio::OpenError, state() devuelve QtAudio::StoppedState y se emite la señal stateChanged().

Esta función se introdujo en Qt 6.11.

Véase también Callback interface.

void QAudioSink::start(QIODevice *device)

Inicia la transferencia de datos de audio desde device a la salida de audio del sistema. El device debe haber sido abierto en los modos ReadOnly o ReadWrite.

Si el QAudioSink es capaz de emitir datos de audio con éxito, state() devuelve QtAudio::ActiveState, error() devuelve QtAudio::NoError y se emite la señal stateChanged().

Si se produce un problema durante este proceso, error() devuelve QtAudio::OpenError, state() devuelve QtAudio::StoppedState y se emite la señal stateChanged().

Véase también QIODevice y QIODevice interface.

QtAudio::State QAudioSink::state() const

Devuelve el estado del procesamiento de audio.

[signal] void QAudioSink::stateChanged(QtAudio::State state)

Esta señal se emite cuando el dispositivo state ha cambiado. Este es el estado actual de la salida de audio.

void QAudioSink::stop()

Detiene la salida de audio, separándose del recurso del sistema.

Establece error() en QtAudio::NoError, state() en QtAudio::StoppedState y emite la señal stateChanged().

Véase también reset().

void QAudioSink::suspend()

Detiene el procesamiento de datos de audio, conservando los datos de audio almacenados en la memoria intermedia.

Establece state() en QtAudio::SuspendedState y emite la señal stateChanged().

qreal QAudioSink::volume() const

Devuelve el volumen entre 0.0 y 1.0 inclusive.

Véase también setVolume().