QAudioSource Class

QFile destinationFile; // Miembro de la claseQAudioSource* audio; // Miembro de clase{ destinationFile.setFileName("/tmp/test.raw"); destinationFile.open( QIODevice::WriteOnly | QIODevice::Truncate );  QAudioFormat format; // Configura el formato deseado, por ejemplo:format.setSampleRate(44100); format.setChannelCount(1); format.setSampleFormat(QAudioFormat::Int16);    QAudioDevice info = QMediaDevices::defaultAudioInput(); if (!info.isFormatSupported(format)) {        qWarning() << "Default format not supported, trying to use the nearest.";
    } audio = new QAudioSource(format, this); connect(audio, &QAudioSource::stateChanged, this, &AudioInputExample::handleStateChanged);    QTimer::singleShot(3000, this, &AudioInputExample::stopRecording);  audio->start(&destinationFile); // Graba audio durante 3000ms}

void AudioInputExample::stopRecording()
{
    audio->stop();
    destinationFile.close();
    delete audio;
}

QAudioSource* audio; // miembro  de la clase .std::atomic<float> peakLevel; // 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 capture audio.";
       return; } audio = new QAudioSource(format, this);  audio->start([&peakLevel] (QSpan<float> interleavedAudioBuffer) { float level = peakLevel.load(); for(float sample : interleavedAudioBuffer) { // Calcula el nivel de pico a partir de las muestras de audiolevel = std::max(level, std::abs(sample)); } peakLevel.store(level); // Nota: hay que tener cuidado si el hilo de la aplicación necesita ser notificado, ya que la // llamada de retorno de audio no debería usar ninguna llamada al sistema potencialmente bloqueante.
       // Buenas opciones son autoreset events (windows), eventfd (linux) o kqueue/EVFILT_USER en macOS.}); if (!audio->error() == QtAudio::Error::NoError) { // además de las otras firmas de start(), iniciar la llamada de retorno de audio fallará si // * el backend no implementa IO basado en llamadas de retorno (la API está disponible en todas las //  principales  plataformas) // * la firma de la llamada de retorno de audio no coincide con format.sampleFormat()
        qWarning() << "Error starting audio output:" << audio->errorString();
    } }

void AudioInputExample::handleStateChanged(QtAudio::State newState)
{
    switch (newState) {
        case QtAudio::StoppedState:
            if (audio->error() != QtAudio::NoError) {
                // Error handling
            } else {
                // Finished recording
            }
            break;

        case QtAudio::ActiveState:
            // Started recording - read from IO device
            break;

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

Documentación de las funciones miembro

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

Construye una nueva entrada de audio y adjúntala a parent. El dispositivo de entrada 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] QAudioSource::QAudioSource(const QAudioDevice &audioDevice, const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

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

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

Destruye esta entrada de audio.

qsizetype QAudioSource::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 se estableció previamente en setBufferSize() o setBufferFrameCount().

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

[since 6.10] qsizetype QAudioSource::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 fue establecido previamente por setBufferSize() o setBufferFrameCount().

Esta función se introdujo en Qt 6.10.

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

qsizetype QAudioSource::bytesAvailable() const

Devuelve la cantidad de datos de audio disponibles para leer en bytes.

Véase también framesAvailable.

qint64 QAudioSource::elapsedUSecs() const

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

QtAudio::Error QAudioSource::error() const

Devuelve el estado de error.

QAudioFormat QAudioSource::format() const

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

[since 6.10] qsizetype QAudioSource::framesAvailable() const

Devuelve la cantidad de datos de audio disponibles para leer en fotogramas.

Nota: el valor devuelto sólo es válido mientras está en estado QtAudio::ActiveState o QtAudio::IdleState, de lo contrario devuelve cero.

Esta función se introdujo en Qt 6.10.

Véase también bytesAvailable.

bool QAudioSource::isNull() const

Devuelve true si la fuente de audio es null, en caso contrario devuelve false.

qint64 QAudioSource::processedUSecs() const

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

void QAudioSource::reset()

Elimina todos los datos de audio de los búferes y los pone a cero.

void QAudioSource::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().

void QAudioSource::setBufferFrameCount(qsizetype value)

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

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

[since 6.10] void QAudioSource::setBufferSize(qsizetype value)

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

Esta función se introdujo en Qt 6.10.

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

void QAudioSource::setVolume(qreal volume)

Establece el volumen de entrada 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.

Si el dispositivo no permite ajustar el volumen de entrada, se ignorará volume y el volumen de entrada permanecerá en 1.0.

El volumen por defecto es 1.0.

Véase también volume().

QIODevice *QAudioSource::start()

Devuelve un puntero al QIODevice interno que se está utilizando para transferir datos desde la entrada de audio del sistema. El dispositivo ya estará abierto y read() puede leer datos directamente de él.

Si QAudioSource 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_source_callback<Callback> = true> void QAudioSource::start(Callback &&cb)

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

Si el QAudioSource es capaz de arrancar con éxito, 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 QAudioSource::start(QIODevice *device)

Inicia la transferencia de datos de audio desde la entrada de audio del sistema al device. El device debe haber sido abierto en los modos WriteOnly, Append o ReadWrite.

Si QAudioSource consigue obtener los datos de audio, state() devuelve QtAudio::ActiveState o 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.

QtAudio::State QAudioSource::state() const

Devuelve el estado del procesamiento de audio.

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

Esta señal se emite cuando el dispositivo state ha cambiado.

void QAudioSource::stop()

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

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

void QAudioSource::suspend()

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

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

qreal QAudioSource::volume() const

Devuelve el volumen de entrada.

Si el dispositivo no permite ajustar el volumen de entrada, el valor devuelto será 1.0.

Véase también setVolume().