AUDIO_STREAM_CATEGORY列舉 (audiosessiontypes.h)

  • 發行項

指定音訊數據流的類別。

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;

常數

 
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 8.1 上執行時一樣，繼續在 Windows 10 上運作相同。 嘗試在 通用 Windows 平台 (UWP) app 中使用這些值，會導致編譯錯誤和運行時間的例外狀況。 在以 Windows 10 SDK 建置的 Windows 傳統型應用程式中使用這些值會導致編譯錯誤。

規格需求

需求 值
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
標頭 audiosessiontypes.h (包含 Audioclient.h)

另請參閱

核心音訊列舉