En esta página

QAmbientSound Class

Un sonido estéreo superpuesto. Más...

Encabezado: #include <QAmbientSound>
CMake: find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio)
qmake: QT += spatialaudio
Heredado de: QObject

Tipos públicos

enum Loops { Infinite, Once }

Propiedades

Funciones públicas

QAmbientSound(QAudioEngine *engine)
bool autoPlay() const
QAudioEngine *engine() const
int loops() const
void setAutoPlay(bool autoPlay)
void setLoops(int loops)
void setSource(const QUrl &url)
void setVolume(float volume)
QUrl source() const
float volume() const

Ranuras públicas

void pause()
void play()
void stop()

Señales

Descripción detallada

QAmbientSound representa un sonido independiente de la posición y la orientación. Se utiliza habitualmente para sonidos de fondo (por ejemplo, música) que se supone que son independientes de la posición y la orientación del oyente.

Nota: QAmbientSound solo está activo cuando el objeto « QAudioEngine » utiliza OutputMode::Stereo u OutputMode::Headphone.

Documentación sobre los tipos de miembros

enum QAmbientSound::Loops

Te permite controlar el bucle de reproducción mediante los siguientes valores:

ConstanteValorDescripción
QAmbientSound::Infinite-1Se reproduce en bucle infinito
QAmbientSound::Once1Detiene la reproducción tras una sola reproducción

Documentación de la propiedad

autoPlay : bool

Determina si el sonido debe empezar a reproducirse automáticamente cuando se especifica una fuente.

El valor por defecto es « true ».

Funciones de acceso:

bool autoPlay() const
void setAutoPlay(bool autoPlay)

Señal de notificación:

void autoPlayChanged()

loops : int

Determina cuántas veces se reproduce el sonido antes de que el reproductor se detenga. Establece el valor en « QAmbientSound::Infinite » para reproducir el sonido actual en bucle de forma indefinida.

El valor por defecto es « 1 ».

Funciones de acceso:

int loops() const
void setLoops(int loops)

Señal de notificación:

void loopsChanged()

source : QUrl

El archivo fuente del sonido que se va a reproducir.

Funciones de acceso:

QUrl source() const
void setSource(const QUrl &url)

Señal de notificación:

void sourceChanged()

volume : float

Define el volumen del sonido.

Los valores entre 0 y 1 atenúan el sonido, mientras que los valores superiores a 1 proporcionan un aumento adicional de la ganancia.

Funciones de acceso:

float volume() const
void setVolume(float volume)

Señal de notificación:

void volumeChanged()

Documentación de funciones de miembro

[explicit] QAmbientSound::QAmbientSound(QAudioEngine *engine)

Crea una fuente de sonido estéreo para « engine ».

Nota: Debe invocarse con un QAudioEngine

QAudioEngine *QAmbientSound::engine() const

Devuelve el motor asociado a este sonido.

[slot] void QAmbientSound::pause()

Detiene la reproducción de sonido. Al llamar a play() se reanudará la reproducción.

[slot] void QAmbientSound::play()

Comienza a reproducir el sonido. No hace nada si el sonido ya se está reproduciendo.

[slot] void QAmbientSound::stop()

Detiene la reproducción del sonido y restablece la posición actual y el recuento de repeticiones a 0. Al llamar a ` play()` se iniciará la reproducción desde el principio del archivo de sonido.

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