En esta página

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.

Captura de pantalla de un gráfico que muestra el nivel de sonido procedente de la entrada de audio de un micrófono

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:

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;

Proyecto de ejemplo en code.qt.io

© 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.