QAmbientSound Class
Un son stéréo en superposition. En savoir plus...
| En-tête : | #include <QAmbientSound> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS SpatialAudio) target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio) |
| qmake : | QT += spatialaudio |
| Hérite de : | 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 couramment 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.
Remarque : QAmbientSound n'est actif que lorsque l'QAudioEngine utilise OutputMode::Stereo ou OutputMode::Headphone.
Documentation sur le type de membre
enum QAmbientSound::Loops
Vous permet de contrôler la boucle de lecture à l'aide des valeurs suivantes :
| Constante | Valeur | Description |
|---|---|---|
QAmbientSound::Infinite | -1 | Boucle à l'infini |
QAmbientSound::Once | 1 | Arrête la lecture après une seule lecture |
Documentation sur les propriétés
autoPlay : bool
Détermine si la lecture du son doit démarrer automatiquement 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 le nombre de fois où le son est lu avant que le lecteur ne s'arrête. Définissez cette option sur « QAmbientSound::Infinite » pour lire le son actuel en boucle indéfiniment.
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
Fichier source du son à lire.
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 de notification :
| void | volumeChanged() |
Documentation des fonctions membres
[explicit] QAmbientSound::QAmbientSound(QAudioEngine *engine)
Crée une source sonore stéréo pour engine.
Remarque : doit être appelé avec un QAudioEngine
QAudioEngine *QAmbientSound::engine() const
Renvoie le moteur associé à ce son.
[slot] void QAmbientSound::pause()
Met la lecture audio en pause. L'appel de la méthode play() permet de reprendre 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 fichier audio et remet à 0 la position courante ainsi que le nombre de boucles en cours. L'appel de la fonction ` play()` relance la lecture depuis le début du fichier audio.
© 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.
