AUDIO_STREAM_CATEGORY 枚举 (audiosessiontypes.h)

  • 项目

指定音频流的类别。

语法

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;

常量

 
AudioCategory_Other
其他音频流。
AudioCategory_ForegroundOnlyMedia
仅在应用位于前台时流式传输的媒体。 此枚举值已弃用。 有关详细信息，请参见“备注”部分。
AudioCategory_BackgroundCapableMedia
当应用在后台时可以流式传输的媒体。 此枚举值已弃用。 有关详细信息，请参见“备注”部分。
AudioCategory_Communications
实时通信，例如 VOIP 或聊天。
AudioCategory_Alerts
警报声音。
AudioCategory_SoundEffects
声音效果。
AudioCategory_GameEffects
游戏声音效果。
AudioCategory_GameMedia
游戏的背景音频。
AudioCategory_GameChat
游戏聊天音频。 与 AudioCategory_Communications 类似，但 AudioCategory_GameChat 不会衰减其他流。
AudioCategory_Speech
语音。
AudioCategory_Movie
包含带对话框的音频的Stream。
AudioCategory_Media
包含不带对话的音频的Stream。
AudioCategory_FarFieldSpeech
媒体是捕获的音频，目的是捕获位于“远场”的语音源。 (远离麦克风。)
AudioCategory_UniformSpeech
媒体是捕获的音频，需要跨所有 Windows 设备对捕获的音频流进行一致的语音处理。 由使用机器学习算法处理语音数据的应用程序使用。
AudioCategory_VoiceTyping
媒体是捕获的音频，目的是通过语音启用听写或键入。

注解

请注意，只有一部分音频流类别对某些流类型有效。

Stream类型 有效类别
呈现流 所有类别都有效。
捕获流 AudioCategory_Communications、AudioCategory_Speech、AudioCategory_Other
环回流 AudioCategory_Other
 

游戏应将其音乐流分类为 AudioCategory_GameMedia 以便当另一个应用程序在后台播放音乐时，游戏音乐会自动静音。 音乐或视频应用程序应将其流分类为 AudioCategory_Media 或 AudioCategory_Movie ，以便它们优先于 AudioCategory_GameMedia 流。 游戏内电影或过场动画的游戏音频，当音频是预混合的或出于创意原因应优先于后台音频时，也应归类为 媒体 或 电影。

AudioCategory_ForegroundOnlyMedia和AudioCategory_BackgroundCapableMedia的值已弃用。 对于 Windows 应用商店应用，在 Windows 10 上运行时，这些值的功能将继续与在 Windows 8.1 上运行相同。 尝试在通用 Windows 平台 (UWP) 应用中使用这些值将导致编译错误和运行时异常。 在使用 Windows 10 SDK 生成的 Windows 桌面应用程序中使用这些值将导致编译错误。

要求

要求 值
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
标头 audiosessiontypes.h (包括 Audioclient.h)

另请参阅

核心音频枚举