QAudioOutput Class

Stellt einen Ausgangskanal für Audio 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
Vererbt: QObject

Eigenschaften

Öffentliche Funktionen

QAudioDevice device() const
bool isMuted() const
float volume() const

Öffentliche Slots

void setDevice(const QAudioDevice &device)
void setMuted(bool muted)
void setVolume(float volume)

Signale

void deviceChanged()
void mutedChanged(bool muted)
void volumeChanged(float volume)

Detaillierte Beschreibung

Diese Klasse stellt einen Ausgabekanal dar, der zusammen mit QMediaPlayer oder QMediaCaptureSession verwendet werden kann. Sie ermöglicht die Auswahl des zu verwendenden physischen Ausgabegeräts, die Stummschaltung des Kanals und die Änderung der Lautstärke des Kanals.

Eigenschaft Dokumentation

device : QAudioDevice

Diese Eigenschaft enthält das Audiogerät, das mit diesem Ausgang verbunden ist.

Die Geräteeigenschaft stellt das Audiogerät dar, an das dieser Ausgang angeschlossen ist. Diese Eigenschaft kann verwendet werden, um ein Ausgabegerät aus der Liste QMediaDevices::audioOutputs() auszuwählen. Sie können den Standard-Audioausgang des Systems auswählen, indem Sie diese Eigenschaft auf ein standardmäßig konstruiertes QAudioDevice Objekt setzen.

Zugriffsfunktionen:

QAudioDevice device() const
void setDevice(const QAudioDevice &device)

Melder-Signal:

void deviceChanged()

muted : bool

Diese Eigenschaft enthält den Stummschaltstatus des aktuellen Mediums.

Der Wert ist 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 enthält die aktuelle Lautstärke.

Die Lautstärke wird linear skaliert und reicht von 0 (Stille) bis 1 (volle Lautstärke).

Hinweis: Werte, die außerhalb dieses Bereichs liegen, werden geklammert.

Standardmäßig ist die Lautstärke 1.

Die Lautstärkeregler der Benutzeroberfläche sollten normalerweise nicht linear skaliert werden. Die Verwendung einer logarithmischen Skala führt beispielsweise zu linearen Änderungen der wahrgenommenen Lautstärke, was der Benutzer normalerweise von einem Lautstärkeregler erwarten würde.

Zugriffsfunktionen:

float volume() const
void setVolume(float volume)

Melder-Signal:

void volumeChanged(float volume)

Siehe auch QtAudio::convertVolume().

© 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.