AudioStateMonitor 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
UWP 앱에서 앱의 오디오 스트림이 현재 음소거 중인지 또는 시스템에 의해 볼륨이 감소하는지 확인할 수 있습니다.
public ref class AudioStateMonitor sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class AudioStateMonitor final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class AudioStateMonitorPublic NotInheritable Class AudioStateMonitor- 상속
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10, version 1803 (10.0.17134.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v6.0에서 도입되었습니다.)
|
설명
Windows는 시스템 이벤트에 대한 응답으로 오디오 스트림의 수준을 동적으로 음소거하거나 낮춥니다. 예를 들어 알람이 울리는 동안 팟캐스트 앱의 오디오 렌더링 스트림 볼륨이 낮아질 수 있습니다. 또는 오디오 녹음 앱은 앱이 백그라운드로 이동할 때 캡처 스트림을 음소거할 수 있습니다. 이 클래스를 사용하면 앱이 오디오 스트림 수준의 변경에 응답할 수 있습니다. 예를 들어 팟캐스트 앱은 시스템에서 소리 수준을 낮출 때 재생을 일시 중지한 다음 볼륨 수준이 정상으로 돌아오면 재생을 다시 시작하도록 선택할 수 있습니다. 또는 오디오 녹음 앱이 캡처 스트림이 음소거되는 동안 녹음을 중지하도록 선택할 수 있습니다.
MediaCategory, AudioDeviceRole, 연결된 오디오 디바이스의 ID 및 스트림이 오디오를 캡처하거나 렌더링하는지 여부에 따라 모니터링되는 스트림을 결정하는 팩터리 메서드 중 하나를 호출하여 AudioStateMonitor를 만듭니다.
SoundLevel 속성을 사용하여 모니터링되는 스트림의 현재 사운드 수준을 확인합니다. 오디오 캡처 또는 재생을 시작하기 전에 이 속성의 값을 검사 오디오 스트림 범주가 음소거되는지 또는 볼륨이 낮아지는지 확인할 수 있습니다. 오디오 스트림 범주의 사운드 수준이 변경될 때 알림을 수신하도록 SoundLevelChanged 이벤트에 대한 처리기를 등록한 다음 SoundLevel 속성을 검사 새 현재 오디오 수준을 확인할 수 있습니다.
UWP 앱에서 AudioStateMonitor 를 사용하는 방법에 대한 자세한 내용은 오디오 상태 변경 내용 검색 및 응답을 참조하세요.
속성
| SoundLevel |
AudioStateMonitor에서 모니터링되는 오디오 스트림의 현재 사운드 수준을 나타내는 값을 가져옵니다. |
메서드
이벤트
| SoundLevelChanged |
시스템이 AudioStateMonitor에서 모니터링하는 오디오 스트림의 사운드 수준을 변경할 때 발생합니다. |