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.
