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 动态静音或降低音频流的级别，以响应系统事件。 例如，当警报响起时，播客应用的音频呈现流的音量可能会降低。 或者，当应用移动到后台时，录音应用可能会将其捕获流静音。 此类允许应用响应其音频流级别的变化。 例如，播客应用可以选择在系统降低音量时暂停播放，然后在音量级别恢复正常时继续播放。 或者，录音应用可以选择在其捕获流静音时停止录制。

通过调用 AudioStateMonitor 工厂方法之一来创建 AudioStateMonitor ，该方法根据 它们的 MediaCategory、 AudioDeviceRole、关联音频设备的 ID 以及流是在捕获还是呈现音频来确定要监视哪些流。

使用 SoundLevel 属性可确定受监视流的当前音量。 可以检查此属性的值，以确定在启动音频捕获或播放之前，某个类别的音频流是静音还是降低其音量。 可以注册 SoundLevelChanged 事件的处理程序，以便在音频流类别的声音级别更改时接收通知，然后检查 SoundLevel 属性来确定新的当前音频级别。

有关在 UWP 应用中使用 AudioStateMonitor 的详细信息，请参阅 检测和响应音频状态更改。

属性

SoundLevel

获取一个值，该值指示 AudioStateMonitor 正在监视的音频流的当前音量。

方法

CreateForCaptureMonitoring()	初始化 AudioStateMonitor 类的新实例，该类监视所有音频捕获流的音量。
CreateForCaptureMonitoring(MediaCategory)	初始化 AudioStateMonitor 类的新实例，该类使用指定的 MediaCategory 监视音频捕获流的音量。
CreateForCaptureMonitoring(MediaCategory, AudioDeviceRole)	初始化 AudioStateMonitor 类的新实例，该类使用指定的 MediaCategory 和 AudioDeviceRole 监视音频捕获流的音量。
CreateForCaptureMonitoringWithCategoryAndDeviceId(MediaCategory, String)	初始化 AudioStateMonitor 类的新实例，该类使用指定的 MediaCategory （使用指定的音频设备）监视音频捕获流的音量。
CreateForRenderMonitoring()	初始化 AudioStateMonitor 类的新实例，该类监视所有音频呈现流的音量。
CreateForRenderMonitoring(AudioRenderCategory)	初始化 AudioStateMonitor 类的新实例，该类使用指定的 MediaCategory 监视音频呈现流的音量。
CreateForRenderMonitoring(AudioRenderCategory, AudioDeviceRole)	初始化 AudioStateMonitor 类的新实例，该类使用指定的 MediaCategory 和 AudioDeviceRole 监视呈现流的音量。
CreateForRenderMonitoringWithCategoryAndDeviceId(AudioRenderCategory, String)	初始化 AudioStateMonitor 类的新实例，该类使用指定的 MediaCategory （使用指定的音频设备）监视音频呈现流的音量。

事件

SoundLevelChanged

当系统更改 AudioStateMonitor 监视的音频流的音量时发生。