XSpeechSynthesizerSetCustomVoice

指定語音合成器要使用指定的自訂語音。

語法

HRESULT XSpeechSynthesizerSetCustomVoice(  
         XSpeechSynthesizerHandle speechSynthesizer,  
         const char* voiceId  
)  

speechSynthesizer _In_
類型：XSpeechSynthesizerHandle 指定將使用自訂語音的語音合成器。 voiceId _In_z_
類型：char* XSpeechSynthesizerVoiceInformation 結構中的語音識別碼，由 XSpeechSynthesizerInstalledVoicesCallback 函式傳回。

類型：HRESULT 如果成功，則傳回 S_OK；否則傳回錯誤碼。如需錯誤碼清單，請參閱錯誤碼。

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱時間敏感執行緒。

對於每個已安裝的語音，XSpeechSynthesizerVoiceInformation 結構會提供語音識別碼、描述、顯示文字、性別、語言及其他資訊。
若要列舉並取得目前裝置上所安裝之語音的相關資訊，請搭配使用 XSpeechSynthesizerEnumerateInstalledVoices 函式與 XSpeechSynthesizerInstalledVoicesCallback 回呼函式。
若要讓指定的語音合成器使用目前的系統語音，請呼叫 XSpeechSynthesizerSetDefaultVoice。
如需示範如何使用 XSpeechSynthesizerSetCustomVoice 函式的範例，請參閱 XSpeechSynthesizerCreate。

標頭： XSpeechSynthesizer.h 程式庫： xgameruntime.lib 支援的平台： Windows、XBOX One 系列主機和 XBOX Series 主機

Last modified on October 6, 2026

⌘I