En esta página

QAudioOutput Class

Representa un canal de salida de audio. Más...

Cabecera: #include <QAudioOutput>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
En QML: AudioOutput
Hereda: QObject

Propiedades

Funciones públicas

QAudioDevice device() const
bool isMuted() const
float volume() const

Ranuras públicas

void setDevice(const QAudioDevice &device)
void setMuted(bool muted)
void setVolume(float volume)

Señales

void deviceChanged()
void mutedChanged(bool muted)
void volumeChanged(float volume)

Descripción detallada

Esta clase representa un canal de salida que puede utilizarse junto con QMediaPlayer o QMediaCaptureSession. Permite seleccionar el dispositivo físico de salida que se va a utilizar, silenciar el canal y cambiar el volumen del canal.

Nota: En la plataforma WebAssembly, debido a su naturaleza asíncrona, la señal QMediaDevices::audioOutputsChanged() se emite cuando la lista de salidas de audio está lista. Se requieren permisos de usuario. Sólo funciona en contextos https seguros.

Documentación de propiedades

device : QAudioDevice

Esta propiedad contiene el dispositivo de audio conectado a esta salida.

La propiedad device representa el dispositivo de audio al que está conectada esta salida. Esta propiedad se puede utilizar para seleccionar un dispositivo de salida de la lista QMediaDevices::audioOutputs(). Puede seleccionar la salida de audio por defecto del sistema estableciendo esta propiedad en un objeto QAudioDevice construido por defecto.

Funciones de acceso:

QAudioDevice device() const
void setDevice(const QAudioDevice &device)

Señal notificadora:

void deviceChanged()

muted : bool

Esta propiedad contiene el estado silenciado del medio actual.

El valor será true si la salida está silenciada; en caso contrario false.

Funciones de acceso:

bool isMuted() const
void setMuted(bool muted)

Señal del notificador:

void mutedChanged(bool muted)

volume : float

Esta propiedad contiene el volumen actual.

El volumen se escala linealmente, desde 0 (silencio) hasta 1 (volumen máximo).

Nota: los valores fuera de este rango serán bloqueados.

Por defecto, el volumen es 1.

Normalmente, los controles de volumen de la interfaz de usuario deben escalarse de forma no lineal. Por ejemplo, utilizar una escala logarítmica producirá cambios lineales en el volumen percibido, que es lo que un usuario esperaría normalmente de un control de volumen.

Funciones de acceso:

float volume() const
void setVolume(float volume)

Señal notificadora:

void volumeChanged(float volume)

Véase también QtAudio::convertVolume().

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