AudioStateMonitor Classe

Definizione

Spazio dei nomi:

Windows.Media.Audio

Consente a un'app UWP di determinare se uno dei flussi audio dell'app è attualmente disattivato o se il volume è ridotto dal 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

Ereditarietà

Object Platform::Object IInspectable AudioStateMonitor

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)

Commenti

Windows disattiva o riduce dinamicamente il livello di flussi audio in risposta agli eventi di sistema. Ad esempio, il volume del flusso di rendering audio di un'app podcast può essere abbassato mentre si attiva un allarme. In alternativa, un'app di registrazione audio potrebbe avere il flusso di acquisizione disattivato quando l'app passa in background. Questa classe consente alle app di rispondere alle modifiche nel livello dei flussi audio. Ad esempio, un'app podcast può scegliere di sospendere la riproduzione quando il livello audio viene abbassato dal sistema e quindi riprendere la riproduzione quando il livello del volume torna normale. In alternativa, un'app di registrazione audio può scegliere di interrompere la registrazione mentre il flusso di acquisizione è disattivato.

Creare un oggetto AudioStateMonitor chiamando uno dei metodi factory che determina quali flussi vengono monitorati in base a MediaCategory, AudioDeviceRole, l'ID del dispositivo audio associato e se il flusso acquisisce o esegue il rendering dell'audio.

Utilizzare la proprietà SoundLevel per determinare il livello audio corrente dei flussi monitorati. Puoi controllare il valore di questa proprietà, per determinare se una categoria di flussi audio verrà disattivata o se il volume verrà abbassato, prima di avviare l'acquisizione o la riproduzione audio. Puoi registrare un gestore per l'evento SoundLevelChanged per ricevere notifiche quando cambia il livello audio di una categoria di flussi audio e quindi controlla la proprietà SoundLevel per determinare il nuovo livello audio corrente.

Per altre informazioni sull'uso di AudioStateMonitor in un'app UWP, vedi Rilevare e rispondere alle modifiche dello stato audio.

Proprietà

SoundLevel

Ottiene un valore che indica il livello audio corrente dei flussi audio monitorati da AudioStateMonitor.

Metodi

CreateForCaptureMonitoring()	Inizializza una nuova istanza della classe AudioStateMonitor che monitora il livello audio per tutti i flussi di acquisizione audio.
CreateForCaptureMonitoring(MediaCategory)	Inizializza una nuova istanza della classe AudioStateMonitor che monitora il livello audio per i flussi di acquisizione audio con l'oggetto MediaCategory specificato.
CreateForCaptureMonitoring(MediaCategory, AudioDeviceRole)	Inizializza una nuova istanza della classe AudioStateMonitor che monitora il livello audio per i flussi di acquisizione audio con mediaCategory e AudioDeviceRole specificati.
CreateForCaptureMonitoringWithCategoryAndDeviceId(MediaCategory, String)	Inizializza una nuova istanza della classe AudioStateMonitor che monitora il livello audio per i flussi di acquisizione audio con l'oggetto MediaCategory specificato che utilizza il dispositivo audio specificato.
CreateForRenderMonitoring()	Inizializza una nuova istanza della classe AudioStateMonitor che monitora il livello audio per tutti i flussi di rendering audio.
CreateForRenderMonitoring(AudioRenderCategory)	Inizializza una nuova istanza della classe AudioStateMonitor che monitora il livello audio per i flussi di rendering audio con l'oggetto MediaCategory specificato.
CreateForRenderMonitoring(AudioRenderCategory, AudioDeviceRole)	Inizializza una nuova istanza della classe AudioStateMonitor che monitora il livello audio per i flussi di rendering con mediaCategory e AudioDeviceRole specificati.
CreateForRenderMonitoringWithCategoryAndDeviceId(AudioRenderCategory, String)	Inizializza una nuova istanza della classe AudioStateMonitor che monitora il livello audio per i flussi di rendering audio con l'oggetto MediaCategory specificato che utilizza il dispositivo audio specificato.

Eventi

SoundLevelChanged

Si verifica quando il sistema modifica il livello audio dei flussi audio monitorati da AudioStateMonitor.