En esta página

QAudioDevice Class

La clase QAudioDevice proporciona información sobre los dispositivos de audio y sus funciones. Más información...

Encabezado: #include <QAudioDevice>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia

Tipos públicos

enum Mode { Null, Input, Output }

Propiedades

Funciones públicas

QAudioDevice()
QAudioDevice(const QAudioDevice &other)
QAudioDevice(QAudioDevice &&other)
~QAudioDevice()
QAudioFormat::ChannelConfig channelConfiguration() const
QString description() const
QByteArray id() const
bool isDefault() const
bool isFormatSupported(const QAudioFormat &settings) const
bool isNull() const
int maximumChannelCount() const
int maximumSampleRate() const
int minimumChannelCount() const
int minimumSampleRate() const
QAudioDevice::Mode mode() const
QAudioFormat preferredFormat() const
QList<QAudioFormat::SampleFormat> supportedSampleFormats() const
void swap(QAudioDevice &other)
bool operator!=(const QAudioDevice &other) const
QAudioDevice &operator=(QAudioDevice &&other)
QAudioDevice &operator=(const QAudioDevice &other)
bool operator==(const QAudioDevice &other) const

Descripción detallada

QAudioDevice describe un dispositivo de audio disponible en el sistema, ya sea para entrada o para reproducción.

Qt utiliza un QAudioDevice para crear clases que se comunican con el dispositivo, como QAudioSource y QAudioSink. También se utiliza para determinar el dispositivo de entrada o salida que se va a utilizar en una sesión de captura o durante la reproducción de contenidos multimedia.

La instancia de QAudioDevice conserva sus propiedades a lo largo de todo su ciclo de vida, incluso si el dispositivo físico correspondiente se desconecta o se modifican sus ajustes. Para realizar un seguimiento de las propiedades actualizadas, el usuario debe cargar nuevas instancias de QAudioDevice desde QMediaDevices cuando se activen las señales pertinentes.

También se puede consultar cada dispositivo para conocer los formatos que admite. En este contexto, un formato es un conjunto compuesto por el número de canales, la frecuencia de muestreo y el tipo de muestra. Un formato viene representado por la clase QAudioFormat.

Los valores admitidos por el dispositivo para cada uno de estos parámetros se pueden obtener con minimumChannelCount(), maximumChannelCount(), minimumSampleRate(), maximumSampleRate() y supportedSampleFormats(). Las combinaciones admitidas dependen de las capacidades del dispositivo de audio. Si necesitas un formato específico, puedes comprobar si el dispositivo lo admite con isFormatSupported(). Por ejemplo:

{
    sourceFile.setFileName("/tmp/test.raw");
    sourceFile.open(QIODevice::ReadOnly);

    QAudioFormat format;
    // Configura el formato, p. ej.:
    format.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(formato, this);
    connect(audio, QAudioSink::stateChanged, this, &AudioInputExample::handleStateChanged);
    audio->start(&sourceFile);
}

El conjunto de dispositivos disponibles se puede obtener a través de la clase QMediaDevices.

Por ejemplo:

const auto devices = QMediaDevices::audioOutputs();
for (const QAudioDevice&device: devices)
    qDebug() << "Device: " << device.description();

En este ejemplo de código, recorremos todos los dispositivos capaces de emitir sonido, es decir, de reproducir un flujo de audio en un formato compatible. Por cada dispositivo que encontramos, simplemente mostramos el deviceName().

Véase también QAudioSink, QAudioSource y QAudioFormat.

Documentación sobre tipos de miembros

enum QAudioDevice::Mode

Describe el modo de funcionamiento de este dispositivo.

ConstanteValorDescripción
QAudioDevice::Null0Un dispositivo nulo.
QAudioDevice::Input1Un dispositivo de entrada.
QAudioDevice::Output2Un dispositivo de salida.

Documentación de propiedades

[read-only] description : const QString

Devuelve un nombre legible para el usuario del dispositivo de audio.

Utiliza esta cadena para presentar el dispositivo al usuario.

Funciones de acceso:

QString description() const

[read-only] id : const QByteArray

Devuelve un identificador del dispositivo de audio.

Los nombres de los dispositivos varían en función de la plataforma o del complemento de audio que se utilice.

Son un identificador único del dispositivo de audio.

Funciones de acceso:

QByteArray id() const

[read-only] isDefault : const bool

Devuelve «true» si se trata del dispositivo de audio predeterminado.

Funciones de acceso:

bool isDefault() const

[read-only] mode : const Mode

Indica si este dispositivo es de entrada o de salida.

Funciones de acceso:

QAudioDevice::Mode mode() const

Documentación de las funciones de miembro

QAudioDevice::QAudioDevice()

Crea un objeto QAudioDevice nulo.

QAudioDevice::QAudioDevice(const QAudioDevice &other)

Crea una copia de other.

[constexpr noexcept default] QAudioDevice::QAudioDevice(QAudioDevice &&other)

Trasladar las construcciones de other.

[noexcept] QAudioDevice::~QAudioDevice()

Elimina esta información sobre el dispositivo de audio.

QAudioFormat::ChannelConfig QAudioDevice::channelConfiguration() const

Devuelve la configuración de canales del dispositivo.

bool QAudioDevice::isFormatSupported(const QAudioFormat &settings) const

Devuelve «true» si el dispositivo de audio descrito en este enlace QAudioDevice admite los settings proporcionados.

bool QAudioDevice::isNull() const

Devuelve si este objeto ` QAudioDevice ` contiene una definición de dispositivo válida.

int QAudioDevice::maximumChannelCount() const

Devuelve el número máximo de canales admitidos.

Normalmente es 1 para el sonido mono o 2 para el sonido estéreo.

int QAudioDevice::maximumSampleRate() const

Devuelve la frecuencia de muestreo máxima admitida (en hercios).

int QAudioDevice::minimumChannelCount() const

Devuelve el número mínimo de canales admitidos.

Normalmente es 1 para el sonido mono o 2 para el sonido estéreo.

int QAudioDevice::minimumSampleRate() const

Devuelve la frecuencia de muestreo mínima admitida (en hercios).

QAudioFormat QAudioDevice::preferredFormat() const

Devuelve la configuración predeterminada del formato de audio para este dispositivo.

Esta configuración la proporciona la plataforma o el complemento de audio que se esté utilizando.

Además, dependen del modo QtAudio::Mode que se esté utilizando.

Un sistema de audio típico ofrecería algo así como:

  • Configuración de entrada: 48 000 Hz, mono, 16 bits.
  • Configuración de salida: 48 000 Hz, estéreo, 16 bits.

QList<QAudioFormat::SampleFormat> QAudioDevice::supportedSampleFormats() const

Devuelve una lista de los tipos de muestra compatibles.

[noexcept] void QAudioDevice::swap(QAudioDevice &other)

Cambia el dispositivo de audio por el « other ».

bool QAudioDevice::operator!=(const QAudioDevice &other) const

Devuelve «true» si esta clase « QAudioDevice » representa un dispositivo de audio distinto de other

[noexcept] QAudioDevice &QAudioDevice::operator=(QAudioDevice &&other)

Traslada « other » a este objeto « QAudioDevice ».

QAudioDevice &QAudioDevice::operator=(const QAudioDevice &other)

Establece el objeto ` QAudioDevice ` para que sea igual a ` other`.

bool QAudioDevice::operator==(const QAudioDevice &other) const

Devuelve «true» si esta clase ` QAudioDevice ` representa el mismo dispositivo de audio que ` other`.

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