Fournir un comportement de canard personnalisé

Une application peut refuser l’expérience de l' utilisation des canards 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 canard personnalisée. par exemple, Lecteur Windows Media fournit sa propre expérience en matière de mise en suspens 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 un canard est inclus dans SDK Windows exemples ; Pour plus d’informations, consultez DuckingMediaPlayer. pour simuler l’expérience de l’ouverture et de la fermeture des flux de communication et la génération d’événements de canard, consultez DuckingCaptureSample, qui est également inclus avec SDK Windows exemples.

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 Audio de base. Un client direct WASAPI peut également remplacer la gestion par défaut s’il sait à quel moment la session de communication démarre et se termine.

Pour fournir une expérience de canard personnalisée, un client WASAPI doit effectuer les tâches suivantes :

  1. Inscrivez-vous pour recevoir des événements de notification du Gestionnaire de canards, un composant du système audio qui gère les notifications relatives aux modifications du flux de communication. Pour plus d’informations, vous obtenez des événements de canard.

    Notes

    Si le client est inscrit pour recevoir des notifications d’inversion, le gestionnaire de canards désactive le comportement par défaut fourni par le système. Si le comportement par défaut est désactivé de manière explicitement (voir désactivation de l’expérience de l’utilisation de l’environnement par défaut) et que le client ne fournit pas de comportement de remplacement, l’application ne rencontre pas de comportement d’inversion.

  2. Écoutez les notifications d’événement Duck envoyées par le gestionnaire de canards et effectuez le comportement de l’encadrement souhaité. Pour plus d’informations sur l’implémentation d’un comportement de mise en œuvre, consultez considérations relatives à l’implémentation pour l’installation de notifications.

Utilisation d’un appareil de communication

Expérience de l’utilisation des canards par défaut

Désactivation de l’expérience de l’utilisation des canards par défaut

Considérations relatives à l’implémentation pour l’installation de notifications

Obtention d’événements de canard