AUDIO_STREAM_CATEGORY enumeração (audiosessiontypes.h)

Especifica a categoria de um fluxo de áudio.

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 Outro fluxo de áudio.
AudioCategory_ForegroundOnlyMedia Mídia que só será transmitida quando o aplicativo estiver em primeiro plano. Esse valor de enumeração foi substituído. Para obter mais informações, consulte a seção Comentários.
AudioCategory_BackgroundCapableMedia Mídia que pode ser transmitida quando o aplicativo está em segundo plano. Esse valor de enumeração foi substituído. Para obter mais informações, consulte a seção Comentários.
AudioCategory_Communications Comunicações em tempo real, como VOIP ou chat.
AudioCategory_Alerts Sons de alerta.
AudioCategory_SoundEffects Efeitos sonoros.
AudioCategory_GameEffects Efeitos sonoros do jogo.
AudioCategory_GameMedia Áudio em segundo plano para jogos.
AudioCategory_GameChat Áudio de chat do jogo. Semelhante a AudioCategory_Communications exceto que AudioCategory_GameChat não atenuará outros fluxos.
AudioCategory_Speech Controle por voz,
AudioCategory_Movie Stream que inclui áudio com caixa de diálogo.
AudioCategory_Media Stream que inclui áudio sem caixa de diálogo.
AudioCategory_FarFieldSpeech A mídia é um áudio capturado com a intenção de capturar fontes de voz localizadas no "campo distante". (Longe do microfone.)
AudioCategory_UniformSpeech A mídia é um áudio capturado que requer processamento de fala consistente para o fluxo de áudio capturado em todos os dispositivos Windows. Usado por aplicativos que processam dados de fala usando algoritmos de machine learning.
AudioCategory_VoiceTyping A mídia é o áudio capturado com a intenção de habilitar o ditado ou digitar por voz.

Comentários

Observe que apenas um subconjunto das categorias de fluxo de áudio é válido para determinados tipos de fluxo.

tipo Stream	Categorias válidas
Renderizar fluxo	Todas as categorias são válidas.
Fluxo de captura	AudioCategory_Communications, AudioCategory_Speech, AudioCategory_Other
Fluxo de loopback	AudioCategory_Other

 

Os jogos devem categorizar seus fluxos de música como AudioCategory_GameMedia para que a música do jogo seja silenciada automaticamente se outro aplicativo reproduzir música em segundo plano. Os aplicativos de música ou vídeo devem categorizar seus fluxos como AudioCategory_Media ou AudioCategory_Movie para que tenham prioridade sobre os fluxos de AudioCategory_GameMedia . O áudio do jogo para cinema ou cutscenes no jogo, quando o áudio é pré-misturado ou por razões criativas deve ter prioridade sobre o áudio em segundo plano, também deve ser categorizado como Mídia ou Filme.

Os valores AudioCategory_ForegroundOnlyMedia e AudioCategory_BackgroundCapableMedia foram preteridos. Para aplicativos da Windows Store, esses valores continuarão funcionando da mesma forma ao serem executados em Windows 10 como em Windows 8.1. Tentar usar esses valores em um aplicativo UWP (Plataforma Universal do Windows) resultará em erros de compilação e uma exceção em runtime. O uso desses valores em um aplicativo da área de trabalho do Windows criado com o SDK do Windows 10 resultará em um erro de compilação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho	audiosessiontypes.h (inclua Audioclient.h)

Confira também

Principais Enumerações de Áudio