enumerazione AUDIO_STREAM_CATEGORY (audiosessiontypes.h)

  • Articolo

Specifica la categoria di un flusso audio.

Sintassi

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;

Costanti

 
AudioCategory_Other
Altro flusso audio.
AudioCategory_ForegroundOnlyMedia
Supporto che verrà trasmesso solo quando l'app è in primo piano. Questo valore di enumerazione è stato deprecato. Per altre informazioni, vedere la sezione Osservazioni.
AudioCategory_BackgroundCapableMedia
Supporti che possono essere trasmessi quando l'app è in background. Questo valore di enumerazione è stato deprecato. Per altre informazioni, vedere la sezione Osservazioni.
AudioCategory_Communications
Comunicazioni in tempo reale, ad esempio VOIP o chat.
AudioCategory_Alerts
Suoni di avviso.
AudioCategory_SoundEffects
Effetti sonori.
AudioCategory_GameEffects
Effetti sonori del gioco.
AudioCategory_GameMedia
Audio in background per i giochi.
AudioCategory_GameChat
Audio della chat di gioco. Analogamente a AudioCategory_Communications , ad eccezione del fatto che AudioCategory_GameChat non attenua altri flussi.
AudioCategory_Speech
Riconoscimento vocale,
AudioCategory_Movie
Stream che include audio con dialogo.
AudioCategory_Media
Stream che include audio senza dialogo.
AudioCategory_FarFieldSpeech
Il supporto multimediale viene acquisito con l'intento di acquisire le origini vocali che si trovano nel "campo lontano". (Lontano dal microfono.
AudioCategory_UniformSpeech
L'audio multimediale viene acquisito che richiede un'elaborazione vocale coerente per il flusso audio acquisito in tutti i dispositivi Windows. Usato dalle applicazioni che elaborano i dati vocali usando algoritmi di Machine Learning.
AudioCategory_VoiceTyping
L'audio viene acquisito con la finalità di abilitare la dettatura o la digitazione tramite voce.

Commenti

Si noti che solo un subset delle categorie di flussi audio è valido per determinati tipi di flusso.

tipo Stream Categorie valide
Flusso di rendering Tutte le categorie sono valide.
Flusso di acquisizione AudioCategory_Communications, AudioCategory_Speech, AudioCategory_Other
Flusso di loopback AudioCategory_Other
 

I giochi devono classificare i flussi musicali come AudioCategory_GameMedia in modo che la musica del gioco muti automaticamente se un'altra applicazione riproduce musica in background. Le applicazioni musicali o video devono classificare i flussi come AudioCategory_Media o AudioCategory_Movie in modo che abbiano la priorità sui flussi AudioCategory_GameMedia . L'audio del gioco per le scene cinematografiche o i cutcene in gioco, quando l'audio viene premixato o per motivi creativi deve avere la priorità sull'audio in background, deve anche essere classificato come Media o Movie.

I valori AudioCategory_ForegroundOnlyMedia e AudioCategory_BackgroundCapableMedia sono deprecati. Per le app di Windows Store, questi valori continueranno a funzionare allo stesso modo quando vengono eseguiti in Windows 10 come in Windows 8.1. Il tentativo di usare questi valori in un'app UWP (piattaforma UWP (Universal Windows Platform)), genererà errori di compilazione e un'eccezione in fase di esecuzione. L'uso di questi valori in un'applicazione desktop di Windows compilata con Windows 10 SDK comporterà un errore di compilazione.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 [app desktop | App UWP]
Intestazione audiosessiontypes.h (include Audioclient.h)

Vedi anche

Enumerazioni audio core