Partager via

DuckingMediaPlayer

Cet exemple d’application illustre l’atténuation du flux en implémentant un lecteur multimédia qui affiche le comportement d’atténuation par défaut fourni par le système, désactive les événements de canardage et implémente une gestion personnalisée lorsque des événements de canardage sont reçus. Cet exemple doit être utilisé conjointement avec DuckingCaptureSample. Pour plus d’informations sur l’atténuation du canard ou du flux, consultez expérience de canardage par défaut.

Cette rubrique contient les sections suivantes.

Descriptif

Cet exemple illustre les fonctionnalités suivantes.

  • DirectShow pour lire un fichier multimédia.
  • WASAPI pour la gestion des flux et la gestion des événements de canardage.

Exigences

Produit Version
sdk Windows Windows 7
Visual Studio 2008

 

Téléchargement de l’exemple

Cet exemple est disponible dans les emplacements suivants.

Emplacement Chemin/URL
Kit de développement logiciel (SDK) Windows \Program Files\Microsoft SDKs\Windows\v7.0\Samples\Multimedia\Audio\DuckingMediaPlayer\...

 

Génération de l’exemple

Pour générer l’exemple DuckingMediaPlayer, procédez comme suit :

  1. Ouvrez le DuckingMediaPlayer.sln dans Visual Studio 2008.
  2. Dans la fenêtre, sélectionnez le de débogage ou configuration de la solution Release, sélectionnez le menu build dans la barre de menus, puis sélectionnez l’option Générer. Si vous n’ouvrez pas Visual Studio à partir de l’interpréteur de commandes CMD pour le Kit de développement logiciel (SDK), Visual Studio n’aura pas accès à l’environnement de génération du SDK. Dans ce cas, l’exemple ne sera pas généré, sauf si vous définissez explicitement la variable d’environnement MSSdk, qui est utilisée dans le fichier projet, DuckingMediaPlayer.vcproj.

Exécution de l’exemple

Si vous générez l’application avec succès, un fichier exécutable, DuckingMediaPlayer.exe, est généré. Pour l’exécuter, sélectionnez Démarrer le débogage ou Démarrer sans débogage dans le menu de débogage ou tapez DuckingMediaPlayer dans une fenêtre de commande.

Pour afficher une démonstration de canardage, vous devez exécuter DuckingMediaPlayer et DuckingCaptureSample simultanément. DuckingCaptureSample ouvre un flux de communication et signale le système pour générer un événement de canardage. Le DuckingMediaPlayer est averti par le système lorsqu’un événement de canardage se produit, et le lecteur multimédia effectue l’action demandée par l’utilisateur.

Pour désactiver le comportement de canardage :

  1. Dans la fenêtre DuckingCaptureSample, sélectionnez Utiliser l’appareil d’entrée par défaut, puis cliquez sur Démarrer pour démarrer une session de capture à partir de l’appareil de communication.
  2. Sur duckingMediaPlayer, sélectionnez un fichier multimédia à lire et spécifiez l’option de canard en tant que Désactiver le canard.

Notez que le fichier multimédia est lu sans interruption. Les événements générés par le système lorsque le flux de communication ouvert sont ignorés.

Pour illustrer le comportement de canardage par défaut fourni par le système, procédez comme suit :

  1. Sélectionnez l’option Sons dans le panneau de configuration. Sous l’onglet Communications, sélectionnez Réduire le volume d’autres sons de 80%.
  2. Dans la fenêtre DuckingCaptureSample, sélectionnez Utiliser l’appareil d’entrée par défaut, puis cliquez sur Démarrer pour démarrer une session de capture à partir de l’appareil de communication.
  3. Sur le DuckingMediaPlayer, sélectionnez un fichier multimédia à lire, sans choisir les options de canardage.
  4. Dans la fenêtre DuckingCaptureSample, cliquez sur Arrêter pour arrêter le flux de communication.

Notez que lorsque DuckingCaptureSample ouvre le flux de communication, le fichier multimédia lu par DuckingMediaPlayer est lu sans interruption, mais le niveau de volume est réduit. Lorsque la session de communication est arrêtée, le volume est réinitialisé au paramètre d’origine. Ce comportement d’atténuation de flux est le comportement de canardage par défaut implémenté par le système.

Pour afficher un comportement de canard personnalisé implémenté par le lecteur multimédia :

  1. Dans la fenêtre DuckingCaptureSample, sélectionnez Utiliser l’appareil d’entrée par défaut, puis cliquez sur Démarrer pour démarrer une session de capture à partir de l’appareil de communication.
  2. Sur duckingMediaPlayer, sélectionnez un fichier multimédia à lire et spécifiez l’option de canard en tant que Pause sur Canard.
  3. Dans la fenêtre DuckingCaptureSample, cliquez sur Arrêter pour arrêter le flux de communication.

Notez que lorsque DuckingCaptureSample ouvre le flux de communication, le fichier multimédia lu par DuckingMediaPlayer est suspendu. La lecture reprend lorsque la session de communication est arrêtée. Ce comportement d’atténuation de flux est le comportement de canard implémenté par le lecteur multimédia.

DuckingMediaPlayer montre également comment intégrer le contrôle de volume pour chaque application au mélangeur de volumes.

Pour plus d’informations sur la fonctionnalité d’atténuation de flux, consultez expérience de canardage par défaut.

exemples de sdk qui utilisent les API audio principales