AudioStateMonitor 클래스

정의

네임스페이스:

Windows.Media.Audio

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 AudioStateMonitor

Public NotInheritable Class AudioStateMonitor

상속

Object Platform::Object IInspectable AudioStateMonitor

특성

ContractVersionAttribute MarshalingBehaviorAttribute

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에서 모니터링되는 오디오 스트림의 현재 사운드 수준을 나타내는 값을 가져옵니다.

메서드

CreateForCaptureMonitoring()	모든 오디오 캡처 스트림의 소리 수준을 모니터링하는 AudioStateMonitor 클래스의 새 instance 초기화합니다.
CreateForCaptureMonitoring(MediaCategory)	지정된 MediaCategory를 사용하여 오디오 캡처 스트림의 사운드 수준을 모니터링하는 AudioStateMonitor 클래스의 새 instance 초기화합니다.
CreateForCaptureMonitoring(MediaCategory, AudioDeviceRole)	지정된 MediaCategory 및 AudioDeviceRole을 사용하여 오디오 캡처 스트림의 소리 수준을 모니터링하는 AudioStateMonitor 클래스의 새 instance 초기화합니다.
CreateForCaptureMonitoringWithCategoryAndDeviceId(MediaCategory, String)	지정된 오디오 디바이스를 사용하는 지정된 MediaCategory를 사용하여 오디오 캡처 스트림의 사운드 수준을 모니터링하는 AudioStateMonitor 클래스의 새 instance 초기화합니다.
CreateForRenderMonitoring()	모든 오디오 렌더링 스트림의 소리 수준을 모니터링하는 AudioStateMonitor 클래스의 새 instance 초기화합니다.
CreateForRenderMonitoring(AudioRenderCategory)	지정된 MediaCategory를 사용하여 오디오 렌더링 스트림의 사운드 수준을 모니터링하는 AudioStateMonitor 클래스의 새 instance 초기화합니다.
CreateForRenderMonitoring(AudioRenderCategory, AudioDeviceRole)	지정된 MediaCategory 및 AudioDeviceRole을 사용하여 렌더링 스트림의 사운드 수준을 모니터링하는 AudioStateMonitor 클래스의 새 instance 초기화합니다.
CreateForRenderMonitoringWithCategoryAndDeviceId(AudioRenderCategory, String)	지정된 오디오 디바이스를 사용하는 지정된 MediaCategory를 사용하여 오디오 렌더링 스트림의 사운드 수준을 모니터링하는 AudioStateMonitor 클래스의 새 instance 초기화합니다.

이벤트

SoundLevelChanged

시스템이 AudioStateMonitor에서 모니터링하는 오디오 스트림의 사운드 수준을 변경할 때 발생합니다.