énumération AUDIO_STREAM_CATEGORY (audiosessiontypes.h)

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

Syntax

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 sera diffusé uniquement lorsque l’application se trouve 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 qui peut ê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énue pas les autres flux.
AudioCategory_Speech Voix,
AudioCategory_Movie Stream qui inclut l’audio avec la boîte de dialogue.
AudioCategory_Media Stream qui inclut l’audio sans dialogue.
AudioCategory_FarFieldSpeech Les médias sont capturés audio avec l’intention de capturer les sources vocales situées dans le « champ lointain ». (Loin du microphone.)
AudioCategory_UniformSpeech Le contenu multimédia est un audio capturé 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 de Machine Learning.
AudioCategory_VoiceTyping Le contenu multimédia est capturé dans le but d’activer la dictée ou la saisie vocale.

Remarques

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

Stream type	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 du jeu soit automatiquement désactivée si une autre application lit de la musique en arrière-plan. Les applications de musique ou de vidéo doivent classer leurs flux comme AudioCategory_Media ou AudioCategory_Movie afin qu’ils soient prioritaires sur AudioCategory_GameMedia flux. L’audio de jeu pour les cinématiques ou les cinématiques dans le jeu, lorsque l’audio est prémixé ou pour des raisons créatives, doit être prioritaire sur l’audio de fond, doit également être classé comme Média ou Film.

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. Toute 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 SDK Windows 10 entraîne une erreur de compilation.

Configuration requise

Condition requise	Valeur
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 (inclure Audioclient.h)

Voir aussi

Énumérations audio principales