AudioStateMonitor 類別

定義

命名空間:

Windows.Media.Audio

允許 UWP app 判斷任何 app 的音訊串流目前是否為靜音，或讓系統減少其音量。

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 ，以根據 其 MediaCategory、 AudioDeviceRole、相關聯音訊裝置的識別碼，以及資料流程是否擷取或轉譯音訊來判斷要監視的資料流程。

使用 SoundLevel 屬性來判斷受監視資料流程目前的音效等級。 您可以在起始音訊擷取或播放之前，先檢查此屬性的值，以判斷音訊串流的類別是否會靜音或降低其音量。 您可以註冊 SoundLevelChanged 事件的處理常式，以在音訊資料流程類別的音效等級變更時接收通知，然後檢查 SoundLevel 屬性以判斷新的目前音訊層級。

如需在 UWP app 中使用 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所監視之音訊資料流程的音效等級時。