Fourniture d’un comportement de canardage personnalisé
Une application peut refuser l’expérience de canardage par défaut gérée par le système et la remplacer par une implémentation personnalisée.
Une application peut fournir une expérience de canardage personnalisée. Par exemple, Lecteur multimédia Windows fournit sa propre expérience de canardage en suspendant le flux multimédia actuel pendant une session de communication et en reprenant la lecture lorsque la session est fermée. Un exemple d’application multimédia qui implémente le canardage est inclus dans les exemples du KIT de développement logiciel (SDK) Windows ; Pour plus d’informations, consultez DuckingMediaPlayer. Pour simuler l’expérience d’ouverture et de fermeture de flux de communication, et de génération d’événements de canardage, consultez DuckingCaptureSample, qui est également inclus avec les exemples du Kit de développement logiciel (SDK) Windows.
Une application multimédia qui lit des sons à atténuer doit être consciente des flux de communication, lorsqu’ils sont ouverts et fermés dans le système. L’implémentation personnalisée peut être fournie à l’aide de MediaFoundation, DirectShow ou DirectSound, qui utilisent les API Core Audio. Un client WASAPI direct peut également remplacer la gestion par défaut s’il sait quand la session de communication commence et se termine.
Pour fournir une expérience de canardage personnalisée, un client WASAPI doit effectuer les tâches suivantes :
Inscrivez-vous pour recevoir les événements de canardage du gestionnaire de canardage, un composant du système audio qui gère les notifications liées aux modifications de flux de communication. Pour plus d’informations, consultez Getting Ducking Events.
Notes
Si le client est inscrit pour recevoir des notifications de canardage, le gestionnaire de canardage désactive le comportement par défaut fourni par le système. Si le comportement par défaut est désactivé de manière plus précise (voir Désactivation de l’expérience de canardage par défaut) et que le client ne fournit pas de comportement de substitution, l’application ne rencontre aucun comportement de mise au point.
Écoutez les notifications d’événements canard envoyées par le gestionnaire de canardage et effectuez le comportement de canardage souhaité. Pour plus d’informations sur l’implémentation d’un comportement de canardage, consultez Considérations d’implémentation pour les notifications de canardage.
Rubriques connexes