AudioStateMonitor Clase

Definición

Espacio de nombres:

Windows.Media.Audio

Permite que una aplicación para UWP determine si alguna de las secuencias de audio de la aplicación se está silenciando o si el sistema reduce su volumen.

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

Herencia

Object Platform::Object IInspectable AudioStateMonitor

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1803 (se introdujo en la versión 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v6.0)

Comentarios

Windowsmuta dinámicamente o reduce el nivel de secuencias de audio en respuesta a eventos del sistema. Por ejemplo, el volumen de la secuencia de representación de audio de una aplicación de podcasts puede reducirse mientras una alarma suena. O bien, una aplicación de grabación de audio puede tener su secuencia de captura silenciada cuando la aplicación se mueve al fondo. Esta clase permite a las aplicaciones responder a los cambios en el nivel de sus secuencias de audio. Por ejemplo, una aplicación de podcast puede optar por pausar la reproducción cuando el sistema reduce el nivel de sonido y, a continuación, reanudar la reproducción cuando el nivel de volumen vuelve a la normalidad. O bien, una aplicación de grabación de audio puede optar por detener la grabación mientras su secuencia de captura está silenciada.

Cree un AudioStateMonitor llamando a uno de sus métodos de fábrica que determina qué secuencias se supervisan en función de sus MediaCategory, AudioDeviceRole, el identificador del dispositivo de audio asociado y si la secuencia está capturando o representando audio.

Utilice la propiedad SoundLevel para determinar el nivel de sonido actual de las secuencias supervisadas. Puede comprobar el valor de esta propiedad para determinar si se silenciará una categoría de secuencias de audio o se reducirá su volumen antes de iniciar la captura o reproducción de audio. Puede registrar un controlador para que el evento SoundLevelChanged reciba notificaciones cuando cambie el nivel de sonido de una categoría de secuencias de audio y, a continuación, compruebe la propiedad SoundLevel para determinar el nuevo nivel de audio actual.

Para obtener más información sobre el uso de AudioStateMonitor en una aplicación para UWP, consulta Detectar y responder a los cambios de estado de audio.

Propiedades

SoundLevel

Obtiene un valor que indica el nivel de sonido actual de las secuencias de audio supervisadas por AudioStateMonitor.

Métodos

CreateForCaptureMonitoring()	Inicializa una nueva instancia de la clase AudioStateMonitor que supervisa el nivel de sonido de todas las secuencias de captura de audio.
CreateForCaptureMonitoring(MediaCategory)	Inicializa una nueva instancia de la clase AudioStateMonitor que supervisa el nivel de sonido de las secuencias de captura de audio con el objeto MediaCategory especificado.
CreateForCaptureMonitoring(MediaCategory, AudioDeviceRole)	Inicializa una nueva instancia de la clase AudioStateMonitor que supervisa el nivel de sonido de las secuencias de captura de audio con el objeto MediaCategory y AudioDeviceRole especificados.
CreateForCaptureMonitoringWithCategoryAndDeviceId(MediaCategory, String)	Inicializa una nueva instancia de la clase AudioStateMonitor que supervisa el nivel de sonido de las secuencias de captura de audio con la clase MediaCategory especificada que usa el dispositivo de audio especificado.
CreateForRenderMonitoring()	Inicializa una nueva instancia de la clase AudioStateMonitor que supervisa el nivel de sonido de todas las secuencias de representación de audio.
CreateForRenderMonitoring(AudioRenderCategory)	Inicializa una nueva instancia de la clase AudioStateMonitor que supervisa el nivel de sonido de las secuencias de representación de audio con el objeto MediaCategory especificado.
CreateForRenderMonitoring(AudioRenderCategory, AudioDeviceRole)	Inicializa una nueva instancia de la clase AudioStateMonitor que supervisa el nivel de sonido de las secuencias de representación con el objeto MediaCategory y AudioDeviceRole especificados.
CreateForRenderMonitoringWithCategoryAndDeviceId(AudioRenderCategory, String)	Inicializa una nueva instancia de la clase AudioStateMonitor que supervisa el nivel de sonido de las secuencias de representación de audio con el objeto MediaCategory especificado que usa el dispositivo de audio especificado.

Eventos

SoundLevelChanged

Se produce cuando el sistema cambia el nivel de sonido de las secuencias de audio que supervisa AudioStateMonitor.