[Microsoft代理程式從 Windows 7 開始已被取代，而且可能無法在後續版本的 Windows 中使用。]
-
描述
-
會傳回或設定用於字元的 TTS 引擎模式。
-
語法
-
代理程式**。字元 （“CharacterID]。TTSModeID** [ = ModeID]
部分 描述 ModeID 對應至語音引擎模式識別碼的字串表達式。
言論
此屬性會決定字元口語輸出的 TTS （文字到語音轉換） 引擎模式識別碼。 TTS 引擎的模式識別碼是由可唯一識別引擎模式的語音廠商所定義的格式化字串。 如需詳細資訊，請參閱在程式碼中 存取語音引擎。
設定此屬性會根據字元的編譯 TTS 設定和字元目前的 LanguageID 設定來覆寫伺服器的載入引擎嘗試。 不過，如果您為未安裝的引擎指定模式標識符，或使用者已在 Microsoft agent 屬性表中停用語音輸出（AudioOutput.Enabled = False），伺服器就會引發錯誤。
如果您未成功設定字元的 TTS 模式識別符，伺服器會檢查字元的已編譯 TTS 模式設定是否符合字元的 LanguageID 設定，以及是否已安裝相關聯的 TTS 引擎。 如果是，字元用於口語輸出的 TTS 模式，此屬性會傳回該模式識別碼。 如果沒有，伺服器會要求相容的 SAPI 語音引擎，以符合字元的 LanguageID，以及針對字元編譯模式標識碼所設定的性別和年齡。 如果您尚未設定字元的 LanguageID，則其 LanguageID 是目前的用戶語言。 如果找不到相符的引擎，則查詢這個屬性會傳回引擎模式標識碼的空字串。 同樣地，如果您在 Microsoft Agent 屬性表中停用語音輸出時查詢此屬性（AudioOutput.Enabled = False），則值會是空字元串。
查詢或設定這個屬性將會載入相關聯的引擎（如果尚未載入）。 不過，如果已安裝字元編譯 TTS 設定中指定的引擎，並符合字元的語言識別元設定，則會在字元載入時載入引擎。
此屬性僅適用於用戶端應用程式使用 字元;這個設定不會影響用戶端應用程式字元或其他字元的其他用戶端。
Microsoft代理程式的語音引擎需求是以 Microsoft 語音 API 為基礎。 支援Microsoft代理程式 SAPI 需求的引擎可以安裝並搭配 Agent 使用。
注意
如果您系統上未安裝相容的音效支援，這個屬性也會傳回空字串。
注意
如果未安裝 Speech.dll，且您指定的引擎不符合字元的已編譯 TTS 模式設定，則設定 TTSModeID 可能會失敗。
注意
查詢此屬性通常不會傳回錯誤。 不過，如果語音引擎需要異常長的時間載入，您可能會收到錯誤，指出查詢逾時。
另請參閱