Muestras de audio frente al nivel de sonido
Este ejemplo muestra un gráfico de las muestras del micrófono frente al nivel de audio.

La implementación de este ejemplo se basa en Widgets. Consulta «Introducción a la programación con Qt Widgets » para obtener información específica al respecto. Las siguientes secciones explican cómo utilizar la API de Qt Charts para mostrar datos dinámicos en un gráfico de muestras frente al nivel de sonido. Para obtener más información sobre el muestreo, consulta «Muestreo (procesamiento de señales)».
Ejecución del ejemplo
Puede ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en « Examples ». Para obtener más información, consulta «Qt Creator: Tutorial: Compilar y ejecutar».
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
Recuperación de los datos de audio
Gracias a la inclusión del módulo Qt Multimedia en main.cpp, creamos un nuevo QAudioDevice que representa el dispositivo de audio predeterminado de la plataforma de destino. También comprobamos si disponemos de un dispositivo de entrada de audio e informamos al usuario si no hay ningún dispositivo de entrada de audio disponible.
if (inputDevice.isNull()) {
QMessageBox::warning(nullptr, "audio",
"There is no audio input device available.");
return -1;
}A continuación, el dispositivo de audio se pasa al widget ` w ` mediante el argumento de su constructor ` w`. Después, se llama a ` w.show() ` para mostrar el widget.
Widget w(inputDevice);
w.resize(800, 600);
w.show();Configuración del gráfico
En esta sección se explica cómo configurar el gráfico y los ejes.
En widget.cpp, el constructor de Widget reimplementado se encarga de la mayor parte del trabajo en lo que respecta a la lógica de la aplicación. Los objetos QChart, QLineSeries y QChartView se declaran de la siguiente manera:
: QWidget(parent)
, m_chart(new QChart)
, m_series(new QLineSeries)
{
auto chartView = new QChartView(m_chart);
m_chart->addSeries(m_series);m_series se utiliza para los datos de entrada de audio.
El eje x «Muestras»
Establecemos el rango de mínimo a máximo en el eje X de 0 a XYSeriesIODevice::sampleCount. (Declarado en xyseriesiodevice.h como 2000). A continuación, establecemos el texto del título.
auto axisX = new QValueAxis;
axisX->setRange(0, XYSeriesIODevice::sampleCount);
axisX->setLabelFormat("%g");
axisX->setTitleText("Samples");El eje y «Nivel de audio»
Creamos el QValueAxis « axisY », establecemos su rango y el texto del título.
auto axisY = new QValueAxis;
axisY->setRange(-1, 1);
axisY->setTitleText("Audio level");Adjuntar los ejes y establecer el título del gráfico
Incorporamos los ejes, ocultamos la leyenda y configuramos el título del gráfico para que incluya el nombre del micrófono que se está utilizando como entrada de audio.
m_chart->addAxis(axisX, Qt::AlignBottom);
m_series->attachAxis(axisX);
m_chart->addAxis(axisY, Qt::AlignLeft);
m_series->attachAxis(axisY);
m_chart->legend()->hide();Diseño del gráfico
Aquí utilizamos un QVBoxLayout mainLayout y añadimos nuestro QChartview chartView al diseño vertical.
m_chart->setTitle("Data from the microphone (" + deviceInfo.description() + ')');
auto mainLayout = new QVBoxLayout(this);Uso de los datos de entrada de audio
En esta sección se muestra cómo se pasan los datos del micrófono a la clase QLineSeries m_series. Al igual que antes, esto se basa en el módulo Qt Multimedia.
En primer lugar, pasamos deviceInfo al constructor de QAudioInput.
mainLayout->addWidget(chartView);
m_audioInput = new QAudioInput(deviceInfo, this);
QAudioFormat formatAudio;A continuación, configuramos nuestro ` QAudioFormat ` formatAudio, su número de canales, la frecuencia de muestreo y el formato de muestra.
formatAudio.setSampleRate(8000);
formatAudio.setChannelCount(1);Ahora podemos crear un ` QAudioSource ` y establecer el tamaño de su búfer.
formatAudio.setSampleFormat(QAudioFormat::UInt8);
m_audioSource = new QAudioSource(deviceInfo, formatAudio);Ahora es el momento de vincular nuestros datos al gráfico. Para ello, hemos creado una clase XYSeriesIODevice. Consulta XYSeriesIODevice para ver cómo está implementada.
m_audioSource->setBufferSize(200);
m_device = new XYSeriesIODevice(m_series, this);
m_device->open(QIODevice::WriteOnly);XYSeriesIODevice
Implementada en ` xyseriesiodevice.cpp`, `XYSeriesIODevice` se encarga del muestreo de la señal. La función ` writeData `, con una resolución fija de 4, establece el tamaño de ` QList ` m_buffer en función del número de muestras y lo rellena con objetos `QPointF` con un valor x incremental y el valor y establecido en 0.
{
static const int resolution = 4;
if (m_buffer.isEmpty()) {
m_buffer.reserve(sampleCount);
for (int i = 0; i < sampleCount; ++i)
m_buffer.append(QPointF(i, 0));
}
int start = 0;A continuación, realizamos algunas muestreos.
const int availableSamples = int(maxSize) / resolution;
if (availableSamples < sampleCount) {
start = sampleCount - availableSamples;
for (int s = 0; s < start; ++s)
m_buffer[s].setY(m_buffer.at(s + availableSamples).y());
}
for (int s = start; s < sampleCount; ++s, data += resolution)
m_buffer[s].setY(qreal(uchar(*data) -128) / qreal(128));
m_series->replace(m_buffer);
return (sampleCount - start) * resolution;© 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.