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 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 사운드 레벨을 모니터링하는 클래스의 새 인스턴스를 초기화합니다.
CreateForCaptureMonitoring(MediaCategory)	지정된 MediaCategory오디오 캡처 스트림의 AudioStateMonitor 사운드 레벨을 모니터링하는 클래스의 새 인스턴스를 초기화합니다.
CreateForCaptureMonitoring(MediaCategory, AudioDeviceRole)	지정된 MediaCategory AudioDeviceRole스트림과 오디오 캡처 스트림의 AudioStateMonitor 사운드 레벨을 모니터링하는 클래스의 새 인스턴스를 초기화합니다.
CreateForCaptureMonitoringWithCategoryAndDeviceId(MediaCategory, String)	지정된 오디오 디바이스를 사용하는 지정된 MediaCategory 오디오 캡처 스트림의 AudioStateMonitor 사운드 레벨을 모니터링하는 클래스의 새 인스턴스를 초기화합니다.
CreateForRenderMonitoring()	모든 오디오 렌더링 스트림의 AudioStateMonitor 사운드 수준을 모니터링하는 클래스의 새 인스턴스를 초기화합니다.
CreateForRenderMonitoring(AudioRenderCategory)	지정된 MediaCategory오디오 렌더링 스트림의 AudioStateMonitor 사운드 수준을 모니터링하는 클래스의 새 인스턴스를 초기화합니다.
CreateForRenderMonitoring(AudioRenderCategory, AudioDeviceRole)	지정된 MediaCategory AudioDeviceRole클래스를 사용하여 렌더링 스트림의 AudioStateMonitor 사운드 수준을 모니터링하는 클래스의 새 인스턴스를 초기화합니다.
CreateForRenderMonitoringWithCategoryAndDeviceId(AudioRenderCategory, String)	지정된 오디오 디바이스를 사용하는 지정된 MediaCategory 오디오 렌더링 스트림의 AudioStateMonitor 사운드 레벨을 모니터링하는 클래스의 새 인스턴스를 초기화합니다.

이벤트

SoundLevelChanged

시스템에서 모니터링 AudioStateMonitor되는 오디오 스트림의 소리 수준을 변경할 때 발생합니다.