QAmbientSound Class
Ein Stereo-Overlay-Sound. Mehr...
| Überschrift: | #include <QAmbientSound> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS SpatialAudio) target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio) |
| qmake: | QT += spatialaudio |
| Erbt von: | 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() |
Ausführliche Beschreibung
QAmbientSound stellt einen positions- und ausrichtungsunabhängigen Klang dar. Er wird häufig für Hintergrundklänge (z. B. Musik) verwendet, die unabhängig von der Position und Ausrichtung des Zuhörers sein sollen.
Hinweis: QAmbientSound ist nur aktiv, wenn der „ QAudioEngine “ den Modus „OutputMode::Stereo“ oder „OutputMode::Headphone“ verwendet.
Dokumentation zum Mitgliedstyp
enum QAmbientSound::Loops
Ermöglicht Ihnen, die Wiedergabeschleife mithilfe der folgenden Werte zu steuern:
| Konstant | Wert | Beschreibung |
|---|---|---|
QAmbientSound::Infinite | -1 | Endlos wiederholen |
QAmbientSound::Once | 1 | Beendet die Wiedergabe nach einmaligem Durchlauf |
Dokumentation zur Eigenschaft
autoPlay : bool
Legt fest, ob die Wiedergabe des Sounds automatisch starten soll, sobald eine Quelle angegeben wird.
Der Standardwert ist „ true “.
Zugriffsfunktionen:
| bool | autoPlay() const |
| void | setAutoPlay(bool autoPlay) |
Benachrichtigungssignal:
| void | autoPlayChanged() |
loops : int
Legt fest, wie oft der Sound abgespielt wird, bevor der Player stoppt. Setzen Sie den Wert auf „ QAmbientSound::Infinite “, um den aktuellen Sound endlos in einer Schleife 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
Legt die Lautstärke des Tons fest.
Werte zwischen 0 und 1 dämpfen den Ton, während Werte über 1 für eine zusätzliche Verstärkung sorgen.
Zugriffsfunktionen:
| float | volume() const |
| void | setVolume(float volume) |
Benachrichtigungssignal:
| void | volumeChanged() |
Dokumentation der Mitgliedsfunktionen
[explicit] QAmbientSound::QAmbientSound(QAudioEngine *engine)
Erstellt eine Stereo-Klangquelle für „ engine “.
Hinweis: Muss mit einem gültigen QAudioEngine
QAudioEngine *QAmbientSound::engine() const
Gibt die diesem Sound zugeordnete Engine zurück.
[slot] void QAmbientSound::pause()
Hält die Tonwiedergabe an. Durch den Aufruf von ` play()` wird die Wiedergabe fortgesetzt.
[slot] void QAmbientSound::play()
Die Wiedergabe des Tons wird gestartet. Es geschieht nichts, wenn der Ton bereits abgespielt wird.
[slot] void QAmbientSound::stop()
Beendet die Wiedergabe des Sounds und setzt die aktuelle Position sowie die aktuelle Schleifenzahl auf 0 zurück. Durch den Aufruf von ` play()` wird die Wiedergabe am Anfang der Sounddatei gestartet.
© 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.
