AudioStateMonitor Classe

Definição

Namespace:

Windows.Media.Audio

Permite que um aplicativo UWP determine se algum dos fluxos de áudio do aplicativo está sendo ativado ou tendo seu volume reduzido pelo sistema.

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

Herança

Object Platform::Object IInspectable AudioStateMonitor

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v6.0)

Comentários

O Windows ativa ou baixa dinamicamente o nível de fluxos de áudio em resposta a eventos do sistema. Por exemplo, o volume do fluxo de renderização de áudio de um aplicativo de podcast pode ser reduzido enquanto um alarme está tocando. Ou um aplicativo de gravação de áudio pode ter seu fluxo de captura silenciado quando o aplicativo é movido para o segundo plano. Essa classe permite que os aplicativos respondam a alterações no nível de seus fluxos de áudio. Por exemplo, um aplicativo de podcast pode optar por pausar a reprodução quando o nível de som é reduzido pelo sistema e, em seguida, retomar a reprodução quando o nível de volume voltar ao normal. Ou, um aplicativo de gravação de áudio pode optar por interromper a gravação enquanto seu fluxo de captura é silenciado.

Crie um AudioStateMonitor chamando um de seus métodos de fábrica que determina quais fluxos são monitorados com base em seu MediaCategory, AudioDeviceRole, a ID do dispositivo de áudio associado e se o fluxo está capturando ou renderizando áudio.

Use a propriedade SoundLevel para determinar o nível de som atual dos fluxos monitorados. Você pode marcar o valor dessa propriedade para determinar se uma categoria de fluxos de áudio será silenciada ou terá seu volume reduzido, antes de iniciar a captura ou a reprodução de áudio. Você pode registrar um manipulador para o evento SoundLevelChanged receber notificações quando o nível de som de uma categoria de fluxos de áudio for alterado e, em seguida, marcar a propriedade SoundLevel para determinar o novo nível de áudio atual.

Para obter mais informações sobre como usar AudioStateMonitor em um aplicativo UWP, consulte Detectar e responder a alterações de estado de áudio.

Propriedades

SoundLevel

Obtém um valor que indica o nível de som atual dos fluxos de áudio que estão sendo monitorados pelo AudioStateMonitor.

Métodos

CreateForCaptureMonitoring()	Inicializa uma nova instância da classe AudioStateMonitor que monitora o nível de som de todos os fluxos de captura de áudio.
CreateForCaptureMonitoring(MediaCategory)	Inicializa uma nova instância da classe AudioStateMonitor que monitora o nível de som para fluxos de captura de áudio com a MediaCategory especificada.
CreateForCaptureMonitoring(MediaCategory, AudioDeviceRole)	Inicializa uma nova instância da classe AudioStateMonitor que monitora o nível de som para fluxos de captura de áudio com MediaCategory e AudioDeviceRole especificados.
CreateForCaptureMonitoringWithCategoryAndDeviceId(MediaCategory, String)	Inicializa uma nova instância da classe AudioStateMonitor que monitora o nível de som para fluxos de captura de áudio com a MediaCategory especificada que está usando o dispositivo de áudio especificado.
CreateForRenderMonitoring()	Inicializa uma nova instância da classe AudioStateMonitor que monitora o nível de som de todos os fluxos de renderização de áudio.
CreateForRenderMonitoring(AudioRenderCategory)	Inicializa uma nova instância da classe AudioStateMonitor que monitora o nível de som para fluxos de renderização de áudio com a MediaCategory especificada.
CreateForRenderMonitoring(AudioRenderCategory, AudioDeviceRole)	Inicializa uma nova instância da classe AudioStateMonitor que monitora o nível de som para fluxos de renderização com MediaCategory e AudioDeviceRole especificados.
CreateForRenderMonitoringWithCategoryAndDeviceId(AudioRenderCategory, String)	Inicializa uma nova instância da classe AudioStateMonitor que monitora o nível de som para fluxos de renderização de áudio com a MediaCategory especificada que está usando o dispositivo de áudio especificado.

Eventos

SoundLevelChanged

Ocorre quando o sistema altera o nível de som dos fluxos de áudio que estão sendo monitorados pelo AudioStateMonitor.