QAmbientSound Class
Un son stéréo superposé. Plus d'informations...
| En-tête : | #include <QAmbientSound> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio) |
| qmake : | QT += spatialaudio |
| Héritages : | QObject |
Types publics
| enum | Loops { Infinite, Once } |
Propriétés
Fonctions publiques
| 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 |
Emplacements publics
Signaux
| void | autoPlayChanged() |
| void | loopsChanged() |
| void | sourceChanged() |
| void | volumeChanged() |
Description détaillée
QAmbientSound représente un son indépendant de la position et de l'orientation. Il est généralement utilisé pour les sons d'ambiance (par exemple la musique) qui sont censés être indépendants de la position et de l'orientation de l'auditeur.
Type de membre Documentation
enum QAmbientSound::Loops
Permet de contrôler la boucle de lecture à l'aide des valeurs suivantes :
| Constante | Valeur | Description de la boucle |
|---|---|---|
QAmbientSound::Infinite | -1 | Boucle infinie |
QAmbientSound::Once | 1 | Arrête la lecture après l'avoir exécutée une fois |
Propriété Documentation
autoPlay : bool
Détermine si le son doit automatiquement commencer à jouer lorsqu'une source est spécifiée.
La valeur par défaut est true.
Fonctions d'accès :
| bool | autoPlay() const |
| void | setAutoPlay(bool autoPlay) |
Signal de notification :
| void | autoPlayChanged() |
loops : int
Détermine combien de fois le son est joué avant que le lecteur ne s'arrête. La valeur QAmbientSound::Infinite permet de jouer le son actuel en boucle à l'infini.
La valeur par défaut est 1.
Fonctions d'accès :
| int | loops() const |
| void | setLoops(int loops) |
Signal de notification :
| void | loopsChanged() |
source : QUrl
Le fichier source du son à jouer.
Fonctions d'accès :
| QUrl | source() const |
| void | setSource(const QUrl &url) |
Signal de notification :
| void | sourceChanged() |
volume : float
Définit le volume du son.
Les valeurs comprises entre 0 et 1 atténuent le son, tandis que les valeurs supérieures à 1 augmentent le gain.
Fonctions d'accès :
| float | volume() const |
| void | setVolume(float volume) |
Signal du notificateur :
| void | volumeChanged() |
Member Function Documentation
[explicit] QAmbientSound::QAmbientSound(QAudioEngine *engine)
Crée une source sonore stéréo pour engine.
QAudioEngine *QAmbientSound::engine() const
Renvoie le moteur associé à ce son.
[slot] void QAmbientSound::pause()
Interrompt la lecture du son. L'appel de play() permet de poursuivre la lecture.
[slot] void QAmbientSound::play()
Lance la lecture du son. Ne fait rien si le son est déjà en cours de lecture.
[slot] void QAmbientSound::stop()
Arrête la lecture du son et remet à 0 la position et le nombre de boucles en cours. L'appel de play() démarre la lecture au début du fichier son.
© 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.
