En esta página

QAudioOutput Class

Representa un canal de salida de audio. Más información...

Encabezado: #include <QAudioOutput>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
En QML: AudioOutput
Heredan de: 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 se puede utilizar junto con ` QMediaPlayer ` o ` QMediaCaptureSession`. Permite seleccionar el dispositivo de salida físico que se va a utilizar, silenciar el canal y ajustar el volumen del mismo.

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

Véase también QAudioInput.

Documentación de la propiedad

device : QAudioDevice

Esta propiedad indica 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 ». Se puede seleccionar la salida de audio predeterminada del sistema estableciendo esta propiedad en un objeto « QAudioDevice » creado de forma predeterminada.

Funciones de acceso:

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

Señal de notificación:

void deviceChanged()

muted : bool

Esta propiedad almacena el estado de silencio del contenido multimedia 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 de notificación:

void mutedChanged(bool muted)

volume : float

Esta propiedad contiene el volumen actual.

El volumen se escala de forma lineal, oscilando entre 0 (silencio) y 1 (volumen máximo).

Nota: los valores fuera de este rango se limitarán.

Por defecto, el volumen es 1.

Los controles de volumen de la interfaz de usuario suelen escalarse de forma no lineal. Por ejemplo, el uso de 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 de notificación:

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.