QAmbientSound Class
Ein Stereo-Overlay-Sound. Mehr...
| Kopfzeile: | #include <QAmbientSound> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio) |
| qmake: | QT += spatialaudio |
| Vererbt: | QObject |
Öffentliche Typen
| enum | Loops { Infinite, Once } |
Eigenschaften
Öffentliche Funktionen
| 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 |
Öffentliche Slots
Signale
| void | autoPlayChanged() |
| void | loopsChanged() |
| void | sourceChanged() |
| void | volumeChanged() |
Detaillierte Beschreibung
QAmbientSound repräsentiert einen positions- und orientierungsunabhängigen Sound. Er wird üblicherweise für Hintergrundgeräusche (z.B. Musik) verwendet, die unabhängig von der Position und Orientierung des Zuhörers sein sollen.
Member-Typ Dokumentation
enum QAmbientSound::Loops
Ermöglicht es Ihnen, die Wiedergabeschleife mit den folgenden Werten zu steuern:
| Konstante | Wert | Beschreibung |
|---|---|---|
QAmbientSound::Infinite | -1 | Unendliche Schleife |
QAmbientSound::Once | 1 | Stoppt die Wiedergabe nach einmaliger Ausführung |
Eigenschaft Dokumentation
autoPlay : bool
Legt fest, ob der Ton automatisch abgespielt werden soll, wenn eine Quelle angegeben wird.
Der Standardwert ist true.
Zugriffsfunktionen:
| bool | autoPlay() const |
| void | setAutoPlay(bool autoPlay) |
Melder-Signal:
| void | autoPlayChanged() |
loops : int
Bestimmt, wie oft der Sound abgespielt wird, bevor der Player stoppt. Setzen Sie den Wert auf QAmbientSound::Infinite, um den aktuellen Sound in einer Endlosschleife abzuspielen.
Der Standardwert ist 1.
Zugriffsfunktionen:
| int | loops() const |
| void | setLoops(int loops) |
Benachrichtigungssignal:
| void | loopsChanged() |
source : QUrl
Die Quelldatei für den abzuspielenden Ton.
Zugriffsfunktionen:
| QUrl | source() const |
| void | setSource(const QUrl &url) |
Benachrichtigungssignal:
| void | sourceChanged() |
volume : float
Bestimmt die Lautstärke des Klangs.
Werte zwischen 0 und 1 dämpfen den Klang, während Werte über 1 eine zusätzliche Anhebung bewirken.
Zugriffsfunktionen:
| float | volume() const |
| void | setVolume(float volume) |
Melder-Signal:
| void | volumeChanged() |
Member Function Dokumentation
[explicit] QAmbientSound::QAmbientSound(QAudioEngine *engine)
Erzeugt eine Stereo-Klangquelle für engine.
QAudioEngine *QAmbientSound::engine() const
Gibt den Motor zurück, der zu diesem Sound gehört.
[slot] void QAmbientSound::pause()
Hält die Tonwiedergabe an. Wenn Sie play() aufrufen, wird die Wiedergabe fortgesetzt.
[slot] void QAmbientSound::play()
Startet die Wiedergabe des Tons. Führt nichts aus, wenn der Ton bereits abgespielt wird.
[slot] void QAmbientSound::stop()
Stoppt die Tonwiedergabe und setzt die aktuelle Position und den aktuellen Schleifenzähler auf 0 zurück. Der Aufruf von play() startet die Wiedergabe am Anfang der Tondatei.
© 2025 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.
