AUDIO_STREAM_CATEGORY-Enumeration (audiosessiontypes.h)

  • Artikel

Gibt die Kategorie eines Audiostreams an.

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;

Konstanten

 
AudioCategory_Other
Anderer Audiostream.
AudioCategory_ForegroundOnlyMedia
Medien, die nur gestreamt werden, wenn sich die App im Vordergrund befindet. Dieser Enumerationswert ist veraltet. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
AudioCategory_BackgroundCapableMedia
Medien, die gestreamt werden können, wenn sich die App im Hintergrund befindet. Dieser Enumerationswert ist veraltet. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
AudioCategory_Communications
Echtzeitkommunikation, z. B. VOIP oder Chat.
AudioCategory_Alerts
Warnungssounds.
AudioCategory_SoundEffects
Soundeffekte:
AudioCategory_GameEffects
Spielsoundeffekte.
AudioCategory_GameMedia
Hintergrundaudio für Spiele.
AudioCategory_GameChat
Audio des Spielechats. Ähnlich wie AudioCategory_Communications mit dem Unterschied, dass AudioCategory_GameChat andere Streams nicht dämpfungsfähig ist.
AudioCategory_Speech
Spracherkennung,
AudioCategory_Movie
Stream, das Audio mit Dialog enthält.
AudioCategory_Media
Stream, die Audio ohne Dialogfeld enthält.
AudioCategory_FarFieldSpeech
Medien sind Audiodaten, die mit der Absicht erfasst werden, Sprachquellen zu erfassen, die sich im "fernen Feld" befinden. (Weit weg vom Mikrofon.)
AudioCategory_UniformSpeech
Medien sind aufgezeichnete Audiodaten, die eine konsistente Sprachverarbeitung für den erfassten Audiodatenstrom auf allen Windows-Geräten erfordern. Wird von Anwendungen verwendet, die Sprachdaten mithilfe von Machine Learning-Algorithmen verarbeiten.
AudioCategory_VoiceTyping
Medien sind Audiodaten, die mit der Absicht erfasst werden, diktieren oder per Stimme eingeben zu können.

Hinweise

Beachten Sie, dass nur eine Teilmenge der Audiostreamkategorien für bestimmte Streamtypen gültig ist.

Stream Typ Gültige Kategorien
Renderdatenstrom Alle Kategorien sind gültig.
Erfassen des Datenstroms AudioCategory_Communications, AudioCategory_Speech, AudioCategory_Other
Loopbackstream AudioCategory_Other
 

Spiele sollten ihre Musikstreams als AudioCategory_GameMedia kategorisieren, sodass Spielmusik automatisch stummgeschaltet wird, wenn eine andere Anwendung Musik im Hintergrund abspielt. Musik- oder Videoanwendungen sollten ihre Streams als AudioCategory_Media oder AudioCategory_Movie kategorisieren, damit sie Vorrang vor AudioCategory_GameMedia Streams haben. Spielaudio für In-Game-Cinematics oder Cutscenes, wenn die Audiowiedergabe vorgemischt ist oder aus kreativen Gründen Vorrang vor Hintergrundaudio haben sollte, sollte auch als Medien oder Film kategorisiert werden.

Die Werte AudioCategory_ForegroundOnlyMedia und AudioCategory_BackgroundCapableMedia sind veraltet. Für Windows Store-Apps funktionieren diese Werte weiterhin genauso, wenn sie auf Windows 10 ausgeführt werden, wie auf Windows 8.1. Der Versuch, diese Werte in einer Universelle Windows-Plattform-App (UWP) zu verwenden, führt zur Laufzeit zu Kompilierungsfehlern und einer Ausnahme. Die Verwendung dieser Werte in einer Windows-Desktopanwendung, die mit dem Windows 10 SDK erstellt wurde, führt zu einem Kompilierungsfehler.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Kopfzeile audiosessiontypes.h (audioclient.h einschließen)

Weitere Informationen

Kernaudioenumeration