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
Señales
| void | autoPlayChanged() |
| void | loopsChanged() |
| void | sourceChanged() |
| void | volumeChanged() |
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:
| Constante | Valor | Descripción |
|---|---|---|
QAmbientSound::Infinite | -1 | Se reproduce en bucle infinito |
QAmbientSound::Once | 1 | Detiene 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.