AudioStateMonitor Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 AudioStateMonitorPublic NotInheritable Class AudioStateMonitor- Ereditarietà
- Attributi
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. |