次の方法で共有


AudioStateMonitor クラス

定義

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
属性

Windows の要件

デバイス ファミリ
Windows 10, version 1803 (10.0.17134.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v6.0 で導入)

注釈

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

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

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

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

プロパティ

SoundLevel

AudioStateMonitor によって監視されているオーディオ ストリームの現在のサウンド レベルを示す値を取得します。

メソッド

CreateForCaptureMonitoring()

すべてのオーディオ キャプチャ ストリームのサウンド レベルを監視する AudioStateMonitor クラスの新しいインスタンスを初期化します。

CreateForCaptureMonitoring(MediaCategory)

指定した MediaCategory を使用してオーディオ キャプチャ ストリームのサウンド レベルを監視する AudioStateMonitor クラスの新しいインスタンスを初期化します。

CreateForCaptureMonitoring(MediaCategory, AudioDeviceRole)

指定した MediaCategoryAudioDeviceRole を使用してオーディオ キャプチャ ストリームのサウンド レベルを監視する AudioStateMonitor クラスの新しいインスタンスを初期化します。

CreateForCaptureMonitoringWithCategoryAndDeviceId(MediaCategory, String)

指定したオーディオ デバイスを使用する指定した MediaCategory を使用して、オーディオ キャプチャ ストリームのサウンド レベルを監視する AudioStateMonitor クラスの新しいインスタンスを初期化します。

CreateForRenderMonitoring()

すべてのオーディオ レンダリング ストリームのサウンド レベルを監視する AudioStateMonitor クラスの新しいインスタンスを初期化します。

CreateForRenderMonitoring(AudioRenderCategory)

指定した MediaCategory を使用してオーディオ レンダリング ストリームのサウンド レベルを監視する AudioStateMonitor クラスの新しいインスタンスを初期化します。

CreateForRenderMonitoring(AudioRenderCategory, AudioDeviceRole)

指定した MediaCategoryAudioDeviceRole を使用して、レンダリング ストリームのサウンド レベルを監視する AudioStateMonitor クラスの新しいインスタンスを初期化します。

CreateForRenderMonitoringWithCategoryAndDeviceId(AudioRenderCategory, String)

指定したオーディオ デバイスを使用する指定した MediaCategory を使用して、オーディオ レンダリング ストリームのサウンド レベルを監視する AudioStateMonitor クラスの新しいインスタンスを初期化します。

イベント

SoundLevelChanged

AudioStateMonitor によって監視されているオーディオ ストリームのサウンド レベルがシステムによって変更されたときに発生します。

適用対象