> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles

> 填入本機聊天控制項支援的文字轉語音設定檔清單。

填入本機聊天控制項支援的文字轉語音設定檔清單。

## 語法

```cpp theme={null}
PartyError PopulateAvailableTextToSpeechProfiles(  
    void* asyncIdentifier  
)  
```

### 參數

**`asyncIdentifier`**   void\*\
*選用*

選用的應用程式定義指標大小內容值，可用來將完成狀態變更與此呼叫相關聯。

### 傳回值

PartyError

`c_partyErrorSuccess` (如果非同步作業已開始)，否則為錯誤碼。如果此方法失敗，將不會產生任何相關的狀態變更。可透過 [PartyManager::GetErrorMessage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) 擷取錯誤碼的人類可讀形式。

## 備註

這是非同步作業；完成時，[PartyManager::StartProcessingStateChanges()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges.md) 會提供 [PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange.md)。 \
\
 非同步作業必須成功完成，才能呼叫 GetAvailableTextToSpeechProfiles()。   \
\
 文字轉語音合成功能在內部會使用可用的區域和延遲測量估計值來最佳化服務使用量。如果使用 [PartyOption::RegionUpdateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyoption.md) 選項將更新模式設定為 [PartyRegionUpdateMode::Deferred](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)，則可能尚未開始擷取可用區域集合並測量與其之間的連線品質，或上次更新可能已超過設定的重新整理間隔時間。如果本機裝置目前未連線或未正在連線到任何網路，PopulateAvailableTextToSpeechProfiles() 會確保任何延後的區域更新已開始，且相關聯的 [PartyRegionsChangedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange.md) 會在此呼叫的 [PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange.md) 完成之前提供。

## 需求

**標頭：** Party.h

## 另請參閱

[PartyLocalChatControl](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol.md)\
[PartyLocalChatControl::GetAvailableTextToSpeechProfiles](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getavailabletexttospeechprofiles.md)\
[PartyLocalChatControl::SetTextToSpeechProfile](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile.md)\
[PartyLocalChatControl::GetTextToSpeechProfile](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_gettexttospeechprofile.md)


## Related topics

- [PartyLocalChatControl::GetAvailableTextToSpeechProfiles](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getavailabletexttospeechprofiles.md)
- [PartyTextToSpeechProfile](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/partytexttospeechprofile.md)
- [PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange.md)
- [PartyRegionUpdateMode](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [PlayFab Party 文字轉換語音與文字輸入 UX 指導方針](https://docs.xbox.com/zh-TW/services/playfab/community/voice-communications/party-text-to-speech-ux-guidelines.md)