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
Warnungsgeräusche.
AudioCategory_SoundEffects
Soundeffekte:
AudioCategory_GameEffects
Soundeffekte des Spiels.
AudioCategory_GameMedia
Hintergrundaudio für Spiele.
AudioCategory_GameChat
Audio des Spielechats. Ähnlich wie AudioCategory_Communications , außer dass AudioCategory_GameChat andere Streams nicht abschwächt.
AudioCategory_Speech
Spracherkennung,
AudioCategory_Movie
Streamen, der Audiodaten mit Dialogfeld enthält.
AudioCategory_Media
Streamen, der Audio ohne Dialogfeld enthält.
AudioCategory_FarFieldSpeech
Medien sind Audioaufnahmen mit der Absicht, Sprachquellen im "fernen Feld" zu erfassen. (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 Algorithmen für maschinelles Lernen verarbeiten.
AudioCategory_VoiceTyping
Medien sind Audiodaten, die mit der Absicht erfasst werden, Diktat oder Spracheingabe zu aktivieren.

Hinweise

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

Streamtyp Gültige Kategorien
Renderdatenstrom Alle Kategorien sind gültig.
Datenstrom erfassen AudioCategory_Communications, AudioCategory_Speech, AudioCategory_Other
Loopbackstream AudioCategory_Other
 

Spiele sollten ihre Musikströme 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-Kinos oder Zwischensequenzen, wenn das Audio 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 bei der Ausführung auf Windows 10 weiterhin genauso 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

   
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Kopfzeile audiosessiontypes.h (include Audioclient.h)

Weitere Informationen

Kernaudioaufzählungen