QAudioBufferInput Class
La clase `QAudioBufferInput` se utiliza para proporcionar búferes de audio personalizados a ` QMediaRecorder ` a través de ` QMediaCaptureSession`. Más información...
| Encabezado: | #include <QAudioBufferInput> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| Desde: | Qt 6.8 |
| Heredado de: | QObject |
Funciones públicas
| QAudioBufferInput(QObject *parent = nullptr) | |
| QAudioBufferInput(const QAudioFormat &format, QObject *parent = nullptr) | |
| virtual | ~QAudioBufferInput() override |
| QMediaCaptureSession * | captureSession() const |
| QAudioFormat | format() const |
| bool | sendAudioBuffer(const QAudioBuffer &audioBuffer) |
Señales
| void | readyToSendAudioBuffer() |
Descripción detallada
QAudioBufferInput solo es compatible con el backend FFmpeg.
Se pueden grabar búferes de audio personalizados conectando un ` QAudioBufferInput ` y un ` QMediaRecorder ` a un ` QMediaCaptureSession`. Para una implementación en modo «pull», llama a ` sendAudioBuffer()` en respuesta a la señal ` readyToSendAudioBuffer()`. En el fragmento de código que aparece a continuación, esto se hace conectando la señal a una ranura en una clase generadora de medios personalizada. La función de la ranura emite otra señal con un nuevo búfer de audio, que se conecta a ` sendAudioBuffer()`:
QMediaCaptureSession session;
QMediaRecorder recorder;
QAudioBufferInput audioInput;
session.setRecorder(&recorder);
session.setAudioBufferInput(&audioInput);
MediaGenerator generator; // Custom class providing audio buffers
connect(&audioInput, &QAudioBufferInput::readyToSendAudioBuffer,
&generator, &MediaGenerator::nextAudioBuffer);
connect(&generator, &MediaGenerator::audioBufferReady,
&audioInput, &QAudioBufferInput::sendAudioBuffer);
recorder.record();A continuación se muestra una implementación mínima de la función de ranura que proporciona búferes de audio:
void MediaGenerator::nextAudioBuffer()
{
QAudioBuffer buffer = nextBuffer();
emit audioBufferReady(buffer);
}Para más detalles, consulta readyToSendAudioBuffer() y sendAudioBuffer().
Véase también QMediaRecorder y QMediaCaptureSession.
Documentación de funciones de miembro
[explicit] QAudioBufferInput::QAudioBufferInput(QObject *parent = nullptr)
Crea un nuevo objeto `QAudioBufferInput` con ` parent`.
[explicit] QAudioBufferInput::QAudioBufferInput(const QAudioFormat &format, QObject *parent = nullptr)
Crea un nuevo objeto `QAudioBufferInput` con los parámetros de audio ` format ` y ` parent`.
El formato especificado ( format ) servirá de indicación para la inicialización del codificador de audio correspondiente al invocar QMediaRecorder::record(). Si no se especifica el formato o este no es válido, el codificador de audio se inicializará al enviar el primer búfer de audio.
Recomendamos especificar el formato si se sabe de antemano qué tipo de búferes de audio se van a enviar.
[override virtual noexcept] QAudioBufferInput::~QAudioBufferInput()
Destruye el objeto.
QMediaCaptureSession *QAudioBufferInput::captureSession() const
Devuelve la sesión de captura a la que está conectada esta entrada de búfer de audio, o un objeto ` nullptr ` si la entrada de búfer de audio no está conectada a ninguna sesión de captura.
Utiliza QMediaCaptureSession::setAudioBufferInput() para conectar la entrada del búfer de audio a una sesión.
QAudioFormat QAudioBufferInput::format() const
Devuelve el formato de audio que se especificó al crear el búfer de audio de entrada.
[signal] void QAudioBufferInput::readyToSendAudioBuffer()
Indica que se puede enviar un nuevo búfer de audio a la entrada del búfer de audio. Tras recibir la señal, si tienes datos de audio que enviar, llama a ` sendAudioBuffer ` una vez o en un bucle hasta que devuelva ` false`.
Véase también sendAudioBuffer().
bool QAudioBufferInput::sendAudioBuffer(const QAudioBuffer &audioBuffer)
Envía QAudioBuffer a QMediaRecorder a través de QMediaCaptureSession.
Devuelve true si el audioBuffer especificado se ha enviado correctamente al destino. Devuelve false si el búfer no se ha enviado, lo cual puede ocurrir si la instancia no está asignada a QMediaCaptureSession, la sesión no dispone de un grabador multimedia, el grabador multimedia no está iniciado o su cola está llena. Se emitirá la señal readyToSendAudioBuffer() tan pronto como el destino pueda gestionar un nuevo búfer de audio.
QMediaRecorder interpreta el envío de un búfer de audio vacío como el final del flujo de entrada. QMediaRecorder detiene la grabación automáticamente si QMediaRecorder::autoStop es true y todas las entradas han notificado el final del flujo.
© 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.