跳轉到主要內容
設定指定類型的文字轉語音作業所要使用的設定檔。

語法

參數

type   PartySynthesizeTextToSpeechType 應使用指定設定檔的文字轉語音作業類型。 profileIdentifier   PartyString 指定類型的文字轉語音作業應使用之設定檔的識別碼。 asyncIdentifier   void*
選用
選用的應用程式定義指標大小內容值,可用來將完成狀態變更與此呼叫相關聯。

傳回值

PartyError c_partyErrorSuccess (如果設定文字轉語音設定檔的非同步作業已開始),否則為錯誤碼。如果此方法失敗,將不會產生任何相關的狀態變更。可透過 PartyManager::GetErrorMessage() 擷取錯誤碼的人類可讀形式。

備註

提供的設定檔會用於所有後續指定相同 type 值的 SynthesizeTextToSpeech() 呼叫。在至少呼叫一次 SetTextToSpeechProfile() 之前,不會設定任何設定檔。因此,必須至少呼叫此方法一次,SynthesizeTextToSpeech() 的呼叫才能成功。

此方法接受設定檔識別碼來表示設定檔選擇,讓遊戲可以傳入 PartyTextToSpeechProfile::GetIdentifier() 的結果,或提供從先前 Party 程式庫工作階段快取的設定檔識別碼。

可以起始多個 SetTextToSpeechProfile() 作業,它們會以非同步方式排入佇列。每個作業都會依序處理和完成。

這是非同步作業;完成時,PartyManager::StartProcessingStateChanges() 會提供 PartySetTextToSpeechProfileCompletedStateChange。

文字轉語音合成功能在內部會使用可用的區域和延遲測量估計值來最佳化服務使用量。如果使用 PartyOption::RegionUpdateConfiguration 選項將更新模式設定為 PartyRegionUpdateMode::Deferred,則可能尚未開始擷取可用區域集合並測量與其之間的連線品質,或上次更新可能已超過設定的重新整理間隔時間。如果本機裝置目前未連線或未正在連線到任何網路,SetTextToSpeechProfile() 會確保任何延後的區域更新已開始,且相關聯的 PartyRegionsChangedStateChange 會在此呼叫的 PartySetTextToSpeechProfileCompletedStateChange 完成之前提供。

需求

標頭: Party.h

另請參閱

PartyLocalChatControl
PartyLocalChatControl::GetTextToSpeechProfile
最後修改於 2026年10月20日