é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