QAudioOutput Class
オーディオ用の出力チャンネルを表します。詳細...
| ヘッダー: | #include <QAudioOutput> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| QML内: | AudioOutput |
| 継承元: | QObject |
プロパティ
パブリック関数
パブリック・スロット
シグナル
| void | deviceChanged() |
| void | mutedChanged(bool muted) |
| void | volumeChanged(float volume) |
詳細説明
このクラスは、QMediaPlayer またはQMediaCaptureSession と組み合わせて使用できる出力チャネルを表します。これにより、使用する物理出力デバイスの選択、チャネルのミュート、およびチャネルの音量変更が可能になります。
注：WebAssemblyプラットフォームでは 、その非同期的な性質上、オーディオ出力のリストの準備が整った時点でQMediaDevices::audioOutputsChanged()シグナルが発信されます。ユーザー権限が必要です。セキュアなhttpsコンテキストでのみ動作します。
QAudioInputも参照してください 。
プロパティのドキュメント
device : QAudioDevice
このプロパティには、この出力に接続されているオーディオデバイスが格納されます。
device プロパティは、この出力に接続されているオーディオデバイスを表します。このプロパティを使用すると、QMediaDevices::audioOutputs のリストから出力デバイスを選択できます。このプロパティにデフォルトで生成されたQAudioDevice オブジェクトを設定することで、システムのデフォルトのオーディオ出力を選択できます。
アクセス関数：
| QAudioDevice | device() const |
| void | setDevice(const QAudioDevice &device) |
通知シグナル:
| void | deviceChanged() |
muted : bool
このプロパティは、現在のメディアのミュート状態を保持します。
出力がミュートされている場合は値が `true ` となり、そうでない場合は `false` となります。
アクセス関数：
| bool | isMuted() const |
| void | setMuted(bool muted) |
通知シグナル：
| void | mutedChanged(bool muted) |
volume : float
このプロパティは現在の音量を保持します。
音量は線形にスケーリングされ、0 （無音）から1 （最大音量）までの範囲となります。
注： この範囲外の値は クリップされます。
デフォルトでは、音量は1 です。
通常、UI の音量コントロールは非線形にスケーリングされるべきです。たとえば、対数スケールを使用すると、知覚される音量が線形に変化します。これは、ユーザーが音量コントロールに通常期待する動作です。
アクセス関数：
| float | volume() const |
| void | setVolume(float volume) |
通知信号：
| void | volumeChanged(float volume) |
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.
