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
- description : const QString
- id : const QByteArray
- isDefault : const bool
- mode : const Mode
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.
| Constante | Valor | Descripción |
|---|---|---|
QAudioDevice::Null | 0 | Un dispositivo nulo. |
QAudioDevice::Input | 1 | Un dispositivo de entrada. |
QAudioDevice::Output | 2 | Un 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.