QAmbientSound Class
Un sonido estéreo superpuesto. Más...
| Cabecera: | #include <QAmbientSound> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio) |
| qmake: | QT += spatialaudio |
| Hereda: | 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
Señales
| void | autoPlayChanged() |
| void | loopsChanged() |
| void | sourceChanged() |
| void | volumeChanged() |
Descripción Detallada
QAmbientSound representa un sonido independiente de la posición y orientación del oyente. Se utiliza comúnmente para sonidos de fondo (por ejemplo, música) que se supone que son independientes de la posición y orientación de los oyentes.
Documentación del tipo de miembro
enum QAmbientSound::Loops
Permite controlar el bucle de reproducción utilizando los siguientes valores:
| Constante | Valor | Descripción |
|---|---|---|
QAmbientSound::Infinite | -1 | Bucle infinito |
QAmbientSound::Once | 1 | Detiene la reproducción después de ejecutarse una vez |
Documentación de propiedades
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 del notificador:
| void | autoPlayChanged() |
loops : int
Determina cuántas veces se reproduce el sonido antes de que el reproductor se detenga. Establézcalo en QAmbientSound::Infinite para reproducir el sonido actual en bucle para siempre.
El valor por defecto es 1.
Funciones de acceso:
| int | loops() const |
| void | setLoops(int loops) |
Señal del notificador:
| 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 aviso:
| 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 del notificador:
| void | volumeChanged() |
Documentación de las funciones miembro
[explicit] QAmbientSound::QAmbientSound(QAudioEngine *engine)
Crea una fuente de sonido estéreo para engine.
QAudioEngine *QAmbientSound::engine() const
Devuelve el motor asociado a este sonido.
[slot] void QAmbientSound::pause()
Detiene la reproducción del sonido. Llamando a play() continuará la reproducción.
[slot] void QAmbientSound::play()
Inicia la reproducción del 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 la cuenta de bucles actual a 0. Si se llama a play(), la reproducción comenzará al 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.
