AudioStateMonitor Klasse

Definition

Namespace:

Windows.Media.Audio

Ermöglicht einer UWP-App zu bestimmen, ob audiostreams der App derzeit stummgeschaltet oder die Lautstärke vom System reduziert wird.

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

Vererbung

Object Platform::Object IInspectable AudioStateMonitor

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v6.0)

Hinweise

Windows schaltet die Audiodatenströme als Reaktion auf Systemereignisse dynamisch stumm oder senkt sie. Beispielsweise kann die Lautstärke des Audiorenderingstreams einer Podcast-App verringert werden, während ein Alarm klingelt. Oder bei einer Audioaufzeichnungs-App kann der Aufnahmedatenstrom stummgeschaltet werden, wenn die App in den Hintergrund verschoben wird. Mit dieser Klasse können Apps auf Änderungen der Ebene ihrer Audiodatenströme reagieren. Beispielsweise kann eine Podcast-App die Wiedergabe anhalten, wenn der Soundpegel vom System gesenkt wird, und dann die Wiedergabe fortsetzen, wenn die Lautstärke wieder normal ist. Oder eine Audioaufzeichnungs-App kann die Aufzeichnung beenden, während der Aufnahmedatenstrom stummgeschaltet ist.

Erstellen Sie einen AudioStateMonitor , indem Sie eine ihrer Factorymethoden aufrufen, die bestimmt, welche Datenströme basierend auf mediaCategory, AudioDeviceRole, der ID des zugeordneten Audiogeräts überwacht werden und ob der Stream Audio erfasst oder gerendert wird.

Verwenden Sie die SoundLevel-Eigenschaft , um den aktuellen Schallpegel der überwachten Streams zu bestimmen. Sie können den Wert dieser Eigenschaft überprüfen, um zu bestimmen, ob eine Kategorie von Audiostreams stummgeschaltet wird oder die Lautstärke verringert wird, bevor Sie die Audioaufnahme oder -wiedergabe initiieren. Sie können einen Handler für das SoundLevelChanged-Ereignis registrieren, um Benachrichtigungen zu erhalten, wenn sich der Soundpegel für eine Kategorie von Audiostreams ändert, und dann die SoundLevel-Eigenschaft überprüfen, um den neuen aktuellen Audiopegel zu bestimmen.

Weitere Informationen zur Verwendung von AudioStateMonitor in einer UWP-App finden Sie unter Erkennen und Reagieren auf Audiozustandsänderungen.

Eigenschaften

SoundLevel

Ruft einen Wert ab, der den aktuellen Soundpegel der Audiostreams angibt, die vom AudioStateMonitor überwacht werden.

Methoden

CreateForCaptureMonitoring()	Initialisiert eine neue instance der AudioStateMonitor-Klasse, die den Soundpegel für alle Audioaufnahmestreams überwacht.
CreateForCaptureMonitoring(MediaCategory)	Initialisiert eine neue instance der AudioStateMonitor-Klasse, die den Soundpegel für Audioaufnahmestreams mit dem angegebenen MediaCategory überwacht.
CreateForCaptureMonitoring(MediaCategory, AudioDeviceRole)	Initialisiert eine neue instance der AudioStateMonitor-Klasse, die den Soundpegel für Audioaufnahmestreams mit den angegebenen MediaCategory und AudioDeviceRole überwacht.
CreateForCaptureMonitoringWithCategoryAndDeviceId(MediaCategory, String)	Initialisiert eine neue instance der AudioStateMonitor-Klasse, die den Soundpegel für Audioaufnahmestreams mit der angegebenen MediaCategory überwacht, die das angegebene Audiogerät verwenden.
CreateForRenderMonitoring()	Initialisiert eine neue instance der AudioStateMonitor-Klasse, die den Soundpegel für alle Audiorenderungsstreams überwacht.
CreateForRenderMonitoring(AudioRenderCategory)	Initialisiert eine neue instance der AudioStateMonitor-Klasse, die den Soundpegel für Audiorenderungsstreams mit dem angegebenen MediaCategory überwacht.
CreateForRenderMonitoring(AudioRenderCategory, AudioDeviceRole)	Initialisiert eine neue instance der AudioStateMonitor-Klasse, die den Soundpegel für Renderstreams mit den angegebenen MediaCategory und AudioDeviceRole überwacht.
CreateForRenderMonitoringWithCategoryAndDeviceId(AudioRenderCategory, String)	Initialisiert eine neue instance der AudioStateMonitor-Klasse, die den Soundpegel für Audiorenderungsstreams mit der angegebenen MediaCategory überwacht, die das angegebene Audiogerät verwenden.

Ereignisse

SoundLevelChanged

Tritt auf, wenn das System den Soundpegel der audiostreams ändert, die vom AudioStateMonitor überwacht werden.