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

# PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles

> 填充本地聊天控件的受支持文本转语音配置文件列表。

填充本地聊天控件的受支持文本转语音配置文件列表。

## Syntax

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

### Parameters

**`asyncIdentifier`**   void\*\
*optional*

可选的、应用定义的指针大小上下文值，可用于将完成状态更改与此调用关联。

### Return value

PartyError

如果异步操作已开始，则返回 `c_partyErrorSuccess`；否则返回错误代码。如果此方法失败，则不会生成相关的状态更改。可通过 [PartyManager::GetErrorMessage()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage) 检索错误代码的可读形式。

## Remarks

这是一个异步操作；完成时将通过 [PartyManager::StartProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) 提供 [PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange)。<br /><br /> 异步操作必须成功完成后才能调用 GetAvailableTextToSpeechProfiles()。   <br /><br /> 文本转语音合成功能在内部使用可用区域和延迟测量估计来优化服务使用。如果使用 [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 选项配置了 [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode) 更新模式，则检索可用区域集及测量到它们的连接质量可能尚未启动，或上次更新可能已超过配置的刷新间隔时限。如果本地设备当前未连接或正在连接到任何网络，PopulateAvailableTextToSpeechProfiles() 可确保任何延迟的区域更新已启动，并且相关联的 [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) 会在此调用的 [PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange) 完成之前提供。

## Requirements

**Header:** Party.h

## See also

[PartyLocalChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)\
[PartyLocalChatControl::GetAvailableTextToSpeechProfiles](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getavailabletexttospeechprofiles)\
[PartyLocalChatControl::SetTextToSpeechProfile](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_settexttospeechprofile)\
[PartyLocalChatControl::GetTextToSpeechProfile](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_gettexttospeechprofile)


## Related topics

- [PartyLocalChatControl::GetAvailableTextToSpeechProfiles](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getavailabletexttospeechprofiles.md)
- [PartyTextToSpeechProfile](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/partytexttospeechprofile.md)
- [PartyPopulateAvailableTextToSpeechProfilesCompletedStateChange](/zh-CN/services/playfab/multiplayer/networking/reference/structs/partypopulateavailabletexttospeechprofilescompletedstatechange.md)
- [PartyRegionUpdateMode](/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode.md)
- [PlayFab Party 文本转语音和文本输入 UX 指南](/zh-CN/services/playfab/community/voice-communications/party-text-to-speech-ux-guidelines.md)