AudioStateMonitor クラス

定義

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 は、システム イベントに応じてオーディオ ストリームのレベルを動的にミュートまたは下げます。 たとえば、アラームが鳴っている間に、ポッドキャスト アプリのオーディオ レンダリング ストリームの音量が下がることがあります。 または、アプリがバックグラウンドに移動したときに、オーディオ録音アプリでキャプチャ ストリームがミュートされる場合があります。 このクラスを使用すると、アプリはオーディオ ストリームのレベルの変化に対応できます。 たとえば、ポッドキャスト アプリでは、システムによってサウンド レベルが下がったときに再生を一時停止し、ボリューム レベルが通常に戻ったときに再生を再開することを選択できます。 または、オーディオ録音アプリでは、キャプチャ ストリームがミュートされている間に録音を停止することを選択できます。

MediaCategory、AudioDeviceRole、関連するオーディオ デバイスの ID、ストリームがオーディオをキャプチャまたはレンダリングしているかどうかに基づいて監視するストリームを決定するファクトリ メソッドのいずれかを呼び出して、AudioStateMonitor を作成します。

監視対象ストリームの現在のサウンド レベルを確認するには、 SoundLevel プロパティを使用します。 オーディオ キャプチャまたは再生を開始する前に、このプロパティの値をチェックして、オーディオ ストリームのカテゴリをミュートにするか、ボリュームを下げるかを判断できます。 SoundLevelChanged イベントのハンドラーを登録して、オーディオ ストリームのカテゴリのサウンド レベルが変更されたときに通知を受け取り、SoundLevel プロパティをチェックして、新しい現在のオーディオ レベルを決定できます。

UWP アプリでの AudioStateMonitor の 使用の詳細については、「 オーディオ状態の変更を検出して応答する」を参照してください。

プロパティ

メソッド

イベント

適用対象