AudioStateMonitor Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 AudioStateMonitorPublic NotInheritable Class AudioStateMonitor- Herencia
- Atributos
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. |