QtAudio Namespace
El espacio de nombres QtAudio contiene enumeraciones que utilizan las clases de audio. Más información...
| Cabecera: | #include <QtAudio> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
Tipos
| enum | Error { NoError, OpenError, IOError, UnderrunError, FatalError } |
| enum | State { ActiveState, SuspendedState, StoppedState, IdleState } |
| enum | VolumeScale { LinearVolumeScale, CubicVolumeScale, LogarithmicVolumeScale, DecibelVolumeScale } |
Funciones
| float | convertVolume(float volume, QtAudio::VolumeScale from, QtAudio::VolumeScale to) |
Documentación de tipos
enum QtAudio::Error
| Constante | Valor | Descripción |
|---|---|---|
QtAudio::NoError | 0 | No se ha producido ningún error |
QtAudio::OpenError | 1 | Se ha producido un error al abrir el dispositivo de audio |
QtAudio::IOError | 2 | Se ha producido un error durante la lectura o escritura del dispositivo de audio. Esto puede ocurrir, por ejemplo, cuando se desconecta una interfaz de audio externa. |
QtAudio::UnderrunError | 3 | Este valor ha quedado obsoleto en Qt-6.11 y Qt ya no lo emite. En su lugar, consulte QtAudio::State::IdleState. Los datos de audio no se están enviando al dispositivo de audio a una velocidad suficiente. |
QtAudio::FatalError | 4 | Se ha producido un error irrecuperable; el dispositivo de audio no se puede utilizar en este momento. |
enum QtAudio::State
| Constante | Valor | Descripción |
|---|---|---|
QtAudio::ActiveState | 0 | Se están procesando datos de audio; este estado se establece tras llamar a start() y mientras haya datos de audio disponibles para su procesamiento. |
QtAudio::SuspendedState | 1 | La secuencia de audio se encuentra en estado suspendido. Se activa tras llamar a suspend() o cuando otra secuencia toma el control del dispositivo de audio. En este último caso, una llamada a resume devolverá el control del dispositivo de audio a esta secuencia. Por lo general, esto solo debería hacerse a petición del usuario. |
QtAudio::StoppedState | 2 | El dispositivo de audio está cerrado y no está procesando ningún dato de audio |
QtAudio::IdleState | 3 | Este estado indica que el sistema de audio está temporalmente inactivo debido a una condición de almacenamiento en búfer. En el caso de un « QAudioSink », el estado «IdleState» significa que no hay suficientes datos disponibles en el « QIODevice » para leer. En el caso de un « QAudioSource », se entra en «IdleState» cuando el búfer circular que alimenta el « QIODevice » se llena. En ese caso, cualquier dato de audio nuevo que llegue desde la interfaz de audio se descarta hasta que la aplicación lea desde el « QIODevice », lo que libera espacio en el búfer. |
enum QtAudio::VolumeScale
Esta enumeración define las diferentes escalas de volumen de audio.
| Constante | Valor | Descripción |
|---|---|---|
QtAudio::LinearVolumeScale | 0 | Escala lineal. 0.0 (0 %) es silencio y 1.0 (100 %) es volumen máximo. Todas las clases de Qt Multimedia que tienen volumen de audio utilizan una escala lineal. |
QtAudio::CubicVolumeScale | 1 | Escala cúbica. 0.0 (0 %) es silencio y 1.0 (100 %) es volumen máximo. |
QtAudio::LogarithmicVolumeScale | 2 | Escala logarítmica. 0.0 (0 %) equivale a silencio y 1.0 (100 %) equivale al volumen máximo. Los controles de volumen de la interfaz de usuario suelen utilizar una escala logarítmica. |
QtAudio::DecibelVolumeScale | 3 | Escala logarítmica en decibelios (dB, amplitud). -200 es silencio y 0 es volumen máximo. |
Véase también QtAudio::convertVolume().
Documentación de la función
float QtAudio::convertVolume(float volume, QtAudio::VolumeScale from, QtAudio::VolumeScale to)
Convierte un objeto de audio volume from una escala de volumen to otra, y devuelve el resultado.
Dependiendo del contexto, se utilizan diferentes escalas para representar el volumen del audio. Todas las clases de Qt Multimedia que tienen volumen de audio utilizan una escala lineal, ya que el volumen de un altavoz se controla modulando su tensión en una escala lineal. El oído humano, por su parte, percibe el volumen de forma logarítmica. Por lo tanto, el uso de una escala logarítmica para los controles de volumen resulta adecuado en la mayoría de las aplicaciones. La escala de decibelios es logarítmica por naturaleza y se utiliza habitualmente para definir los niveles de sonido; suele emplearse para los controles de volumen de la interfaz de usuario en aplicaciones de audio profesionales. La escala cúbica es una aproximación de bajo coste computacional a una escala logarítmica y proporciona un mayor control sobre los niveles de volumen más bajos.
El siguiente ejemplo muestra cómo convertir el valor de volumen de un control deslizante antes de pasarlo a un ` QMediaPlayer`. Como resultado, el aumento percibido en el volumen es el mismo al subir el control deslizante de volumen de 20 a 30 que al hacerlo de 50 a 60:
void applyVolume(int volumeSliderValue)
{
// volumeSliderValue is in the range [0..100]
qreal linearVolume = QtAudio::convertVolume(volumeSliderValue / qreal(100.0),
QtAudio::LogarithmicVolumeScale,
QtAudio::LinearVolumeScale);
player.setVolume(qRound(linearVolume * 100));
}Véase también ` VolumeScale`, ` QAudioSink::setVolume()`, ` QAudioSource::setVolume()` y ` QSoundEffect::setVolume()`.
© 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.