QAudioOutput Class
Stellt einen Audio-Ausgangskanal dar. Mehr...
| Kopfzeile: | #include <QAudioOutput> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| In QML: | AudioOutput |
| Erbt von: | QObject |
Eigenschaften
Öffentliche Funktionen
Öffentliche Slots
Signale
| void | deviceChanged() |
| void | mutedChanged(bool muted) |
| void | volumeChanged(float volume) |
Detaillierte Beschreibung
Diese Klasse repräsentiert einen Ausgangskanal, der zusammen mit ` QMediaPlayer ` oder ` QMediaCaptureSession` verwendet werden kann. Sie ermöglicht die Auswahl des zu verwendenden physischen Ausgabegeräts, das Stummschalten des Kanals und die Änderung der Lautstärke des Kanals.
Hinweis: Auf der WebAssembly-Plattform wird aufgrund ihres asynchronen Charakters das Signal „ QMediaDevices::audioOutputsChanged()“ ausgegeben, sobald die Liste der Audioausgänge bereitsteht. Es sind Benutzerberechtigungen erforderlich. Funktioniert nur in sicheren HTTPS-Kontexten.
Siehe auch QAudioInput.
Dokumentation zur Eigenschaft
device : QAudioDevice
Diese Eigenschaft gibt das an diesen Ausgang angeschlossene Audiogerät an.
Die Eigenschaft „device“ stellt das Audiogerät dar, an das dieser Ausgang angeschlossen ist. Mit dieser Eigenschaft kann ein Ausgabegerät aus der Liste „ QMediaDevices::audioOutputs “ ausgewählt werden. Sie können den systemweiten Standard-Audioausgang auswählen, indem Sie diese Eigenschaft auf ein standardmäßig erstelltes „ QAudioDevice “-Objekt setzen.
Zugriffsfunktionen:
| QAudioDevice | device() const |
| void | setDevice(const QAudioDevice &device) |
Benachrichtigungssignal:
| void | deviceChanged() |
muted : bool
Diese Eigenschaft gibt den Stummschaltstatus des aktuellen Mediums an.
Der Wert lautet „ true “, wenn die Ausgabe stummgeschaltet ist; andernfalls „ false “.
Zugriffsfunktionen:
| bool | isMuted() const |
| void | setMuted(bool muted) |
Benachrichtigungssignal:
| void | mutedChanged(bool muted) |
volume : float
Diese Eigenschaft gibt die aktuelle Lautstärke an.
Die Lautstärke wird linear skaliert und reicht von 0 (Stille) bis 1 (volle Lautstärke).
Hinweis: Werte außerhalb dieses Bereichs werden auf den zulässigen Bereich begrenzt.
Standardmäßig beträgt die Lautstärke 1.
Lautstärkeregler in der Benutzeroberfläche sollten in der Regel nichtlinear skaliert werden. Die Verwendung einer logarithmischen Skalierung führt beispielsweise zu linearen Änderungen der wahrgenommenen Lautstärke – genau das, was ein Benutzer normalerweise von einem Lautstärkeregler erwartet.
Zugriffsfunktionen:
| float | volume() const |
| void | setVolume(float volume) |
Benachrichtigungssignal:
| void | volumeChanged(float volume) |
Siehe auch QtAudio::convertVolume().
© 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.
