AudioStateMonitor クラス

リファレンス

定義

名前空間:: Windows.Media.Audio

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

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

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

適用対象