Fornire un comportamento personalizzato di anatraggio

Un'applicazione può rifiutare esplicitamente l'esperienza predefinita Ducking gestita dal sistema e sostituirla con un'implementazione personalizzata.

Un'applicazione può offrire un'esperienza personalizzata di anatraggio. Ad esempio, Lettore multimediale Windows offre la propria esperienza di anatraggio sospendo il flusso multimediale corrente durante una sessione di comunicazione e riprendendo la riproduzione quando la sessione viene chiusa. Un'applicazione multimediale di esempio che implementa l'anatraggio è inclusa negli esempi di Windows SDK; per altre informazioni, vedi DuckingMediaPlayer. Per simulare l'esperienza di apertura e chiusura dei flussi di comunicazione e la generazione di eventi di anatraggio, vedere DuckingCaptureSample, incluso anche negli esempi di Windows SDK.

Un'applicazione multimediale che riproduce suoni da attenuare deve essere consapevole dei flussi di comunicazione, quando vengono aperti e chiusi nel sistema. L'implementazione personalizzata può essere fornita tramite MediaFoundation, DirectShow o DirectSound, che usano le API Audio principali. Un client WASAPI diretto può anche eseguire l'override della gestione predefinita se sa quando viene avviata e terminata la sessione di comunicazione.

Per offrire un'esperienza personalizzata di anatraggio, un client WASAPI deve eseguire le attività seguenti:

1. Registra per ricevere eventi di anatraggio dal gestore di anatraggio, un componente del sistema audio che gestisce le notifiche correlate alle modifiche del flusso di comunicazione. Per altre informazioni, ottenere eventi di anatraggio.

   Nota

   Se il client è registrato per ricevere notifiche di anatraggio, il gestore di anatraggio disabilita il comportamento predefinito fornito dal sistema. Se il comportamento predefinito è disabilitato esplicitamente (vedere Disabilitazione dell'esperienza di anatratura predefinita) e il client non fornisce un comportamento sostitutivo, l'applicazione non riscontra alcun comportamento di anatraggio.

    

2. Ascoltare le notifiche degli eventi anatra inviate dal manager di anatraggio ed eseguire il comportamento di anatraggio desiderato. Per altre informazioni sull'implementazione di un comportamento di anatraggio, vedere Considerazioni sull'implementazione per le notifiche ducking.

Argomenti correlati

Uso di un dispositivo di comunicazione

Esperienza predefinita di anatraggio

Disabilitazione dell'esperienza predefinita di ducking

Considerazioni sull'implementazione per le notifiche di ducking

Recupero di eventi di anatraggio