énumération AUDIO_STREAM_CATEGORY (audiosessiontypes.h)

Spécifie la catégorie d’un flux audio.

Syntaxe

typedef enum _AUDIO_STREAM_CATEGORY {
  AudioCategory_Other,
  AudioCategory_ForegroundOnlyMedia,
  AudioCategory_BackgroundCapableMedia,
  AudioCategory_Communications,
  AudioCategory_Alerts,
  AudioCategory_SoundEffects,
  AudioCategory_GameEffects,
  AudioCategory_GameMedia,
  AudioCategory_GameChat,
  AudioCategory_Speech,
  AudioCategory_Movie,
  AudioCategory_Media,
  AudioCategory_FarFieldSpeech,
  AudioCategory_UniformSpeech,
  AudioCategory_VoiceTyping
} AUDIO_STREAM_CATEGORY;

Constantes

 
AudioCategory_Other
Autre flux audio.
AudioCategory_ForegroundOnlyMedia
Média qui ne diffusera que lorsque l’application est au premier plan. Cette valeur d'énumération est dépréciée. Pour plus d'informations, consultez la section Notes.
AudioCategory_BackgroundCapableMedia
Média pouvant être diffusé en continu lorsque l’application est en arrière-plan. Cette valeur d'énumération est dépréciée. Pour plus d'informations, consultez la section Notes.
AudioCategory_Communications
Communications en temps réel, telles que VOIP ou conversation.
AudioCategory_Alerts
Sons d’alerte.
AudioCategory_SoundEffects
Effets sonores.
AudioCategory_GameEffects
Effets sonores du jeu.
AudioCategory_GameMedia
Audio d’arrière-plan pour les jeux.
AudioCategory_GameChat
Audio de conversation de jeu. Semblable à AudioCategory_Communications sauf que AudioCategory_GameChat n’atténuera pas d’autres flux.
AudioCategory_Speech
Voix,
AudioCategory_Movie
Diffuser en continu l’audio avec la boîte de dialogue.
AudioCategory_Media
Diffuser en continu l’audio sans boîte de dialogue.
AudioCategory_FarFieldSpeech
Le média est audio capturé avec l’intention de capturer des sources vocales situées dans le « champ lointain ». (Loin du microphone.)
AudioCategory_UniformSpeech
Le média est capturé audio qui nécessite un traitement vocal cohérent pour le flux audio capturé sur tous les appareils Windows. Utilisé par les applications qui traitent les données vocales à l’aide d’algorithmes Machine Learning.
AudioCategory_VoiceTyping
Le média est capturé avec l’intention d’activer la dictée ou de taper par voix.

Notes

Notez que seul un sous-ensemble des catégories de flux audio est valide pour certains types de flux.

Type de flux Catégories valides
Flux de rendu Toutes les catégories sont valides.
Flux de capture AudioCategory_Communications, AudioCategory_Speech, AudioCategory_Other
Flux de bouclage AudioCategory_Other
 

Les jeux doivent classer leurs flux de musique comme AudioCategory_GameMedia afin que la musique de jeu se mute automatiquement si une autre application joue de la musique en arrière-plan. Les applications musicales ou vidéo doivent classer leurs flux comme AudioCategory_Media ou AudioCategory_Movie afin qu’elles prennent priorité sur les flux AudioCategory_GameMedia . L’audio de jeu pour les cinématiques ou les coupures de jeu, lorsque l’audio est prémixé ou pour des raisons créatives doit être prioritaire sur l’audio d’arrière-plan, doit également être classé comme Media ou Movie.

Les valeurs AudioCategory_ForegroundOnlyMedia et AudioCategory_BackgroundCapableMedia sont déconseillées. Pour les applications du Windows Store, ces valeurs continuent de fonctionner de la même façon lors de l’exécution sur Windows 10 que sur Windows 8.1. La tentative d’utilisation de ces valeurs dans une application plateforme Windows universelle (UWP), entraîne des erreurs de compilation et une exception au moment de l’exécution. L’utilisation de ces valeurs dans une application de bureau Windows créée avec le KIT DE développement logiciel (SDK) Windows 10 entraîne une erreur de compilation.

Configuration requise

   
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
En-tête audiosessiontypes.h (include Audioclient.h)

Voir aussi

Énumérations audio principales