AudioStateMonitor Classe

Définition

Espace de noms:

Windows.Media.Audio

Permet à une application UWP de déterminer si l’un des flux audio de l’application est actuellement désactivé ou si son volume est réduit par le système.

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

Héritage

Object Platform::Object IInspectable AudioStateMonitor

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1803 (introduit dans 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v6.0)

Remarques

Windows désactive ou réduit dynamiquement le niveau de flux audio en réponse aux événements système. Par exemple, le volume du flux de rendu audio d’une application de podcast peut être réduit pendant qu’une alarme sonne. Ou une application d’enregistrement audio peut avoir son flux de capture désactivé lorsque l’application passe à l’arrière-plan. Cette classe permet aux applications de répondre aux changements dans le niveau de leurs flux audio. Par exemple, une application de podcast peut choisir de suspendre la lecture lorsque le niveau sonore est abaissé par le système, puis de reprendre la lecture lorsque le niveau de volume revient à la normale. Ou, une application d’enregistrement audio peut choisir d’arrêter l’enregistrement pendant que son flux de capture est désactivé.

Créez un AudioStateMonitor en appelant l’une de ses méthodes de fabrique qui détermine les flux surveillés en fonction de leur MediaCategory, audioDeviceRole, de l’ID du périphérique audio associé et de la capture ou du rendu audio du flux.

Utilisez la propriété SoundLevel pour déterminer le niveau sonore actuel des flux surveillés. Vous pouvez case activée la valeur de cette propriété pour déterminer si une catégorie de flux audio sera désactivée ou si son volume sera réduit, avant de lancer la capture ou la lecture audio. Vous pouvez inscrire un gestionnaire pour l’événement SoundLevelChanged afin de recevoir des notifications lorsque le niveau sonore d’une catégorie de flux audio change, puis case activée la propriété SoundLevel pour déterminer le nouveau niveau audio actuel.

Pour plus d’informations sur l’utilisation d’AudioStateMonitor dans une application UWP, consultez Détecter et répondre aux modifications d’état audio.

Propriétés

SoundLevel

Obtient une valeur indiquant le niveau sonore actuel des flux audio surveillés par AudioStateMonitor.

Méthodes

CreateForCaptureMonitoring()	Initialise une nouvelle instance de la classe AudioStateMonitor qui surveille le niveau sonore de tous les flux de capture audio.
CreateForCaptureMonitoring(MediaCategory)	Initialise une nouvelle instance de la classe AudioStateMonitor qui surveille le niveau sonore pour les flux de capture audio avec la MediaCategory spécifiée.
CreateForCaptureMonitoring(MediaCategory, AudioDeviceRole)	Initialise une nouvelle instance de la classe AudioStateMonitor qui surveille le niveau sonore pour les flux de capture audio avec mediaCategory et AudioDeviceRole spécifiés.
CreateForCaptureMonitoringWithCategoryAndDeviceId(MediaCategory, String)	Initialise une nouvelle instance de la classe AudioStateMonitor qui surveille le niveau sonore pour les flux de capture audio avec la MediaCategory spécifiée qui utilisent le périphérique audio spécifié.
CreateForRenderMonitoring()	Initialise une nouvelle instance de la classe AudioStateMonitor qui surveille le niveau sonore de tous les flux de rendu audio.
CreateForRenderMonitoring(AudioRenderCategory)	Initialise une nouvelle instance de la classe AudioStateMonitor qui surveille le niveau sonore pour les flux de rendu audio avec la classe MediaCategory spécifiée.
CreateForRenderMonitoring(AudioRenderCategory, AudioDeviceRole)	Initialise une nouvelle instance de la classe AudioStateMonitor qui surveille le niveau sonore pour les flux de rendu avec mediaCategory et AudioDeviceRole spécifiés.
CreateForRenderMonitoringWithCategoryAndDeviceId(AudioRenderCategory, String)	Initialise une nouvelle instance de la classe AudioStateMonitor qui surveille le niveau sonore pour les flux de rendu audio avec la MediaCategory spécifiée qui utilise le périphérique audio spécifié.

Événements

SoundLevelChanged

Se produit lorsque le système modifie le niveau sonore des flux audio surveillés par AudioStateMonitor.