> ## 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::SetTextToSpeechProfile

> 为指定类型的文本转语音操作配置要使用的配置文件。

为指定类型的文本转语音操作配置要使用的配置文件。

## Syntax

```cpp theme={null}
PartyError SetTextToSpeechProfile(  
    PartySynthesizeTextToSpeechType type,  
    PartyString profileIdentifier,  
    void* asyncIdentifier  
)  
```

### Parameters

**`type`**   [PartySynthesizeTextToSpeechType](/services/playfab/multiplayer/networking/reference/enums/partysynthesizetexttospeechtype)

应使用指定配置文件的文本转语音操作类型。

**`profileIdentifier`**   [PartyString](/services/playfab/multiplayer/networking/reference/typedefs)

指定类型的文本转语音操作应使用的配置文件的标识符。

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

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

### Return value

PartyError

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

## Remarks

提供的配置文件将用于所有后续为 `type` 指定相同值的 [SynthesizeTextToSpeech()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_synthesizetexttospeech) 调用。在至少调用一次 SetTextToSpeechProfile() 之前，不会配置任何配置文件。因此，必须至少调用此方法一次，任何对 SynthesizeTextToSpeech() 的调用才能成功。<br /><br /> 此方法接受配置文件标识符以指示配置文件选择，以便标题可以传入 [PartyTextToSpeechProfile::GetIdentifier()](/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/methods/partytexttospeechprofile_getidentifier) 的结果，或者提供从之前 Party 库会话缓存的配置文件标识符。   <br /><br /> 可以启动多个 SetTextToSpeechProfile() 操作，它们将以异步方式排队。每个操作将按顺序处理和完成。   <br /><br /> 这是一个异步操作；完成时将通过 [PartyManager::StartProcessingStateChanges()](/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_startprocessingstatechanges) 提供 [PartySetTextToSpeechProfileCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange)。   <br /><br /> 文本转语音合成功能在内部使用可用区域和延迟测量估计来优化服务使用。如果使用 [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 选项配置了 [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode) 更新模式，则检索可用区域集及测量到它们的连接质量可能尚未启动，或上次更新可能已超过配置的刷新间隔时限。如果本地设备当前未连接或正在连接到任何网络，SetTextToSpeechProfile() 可确保任何延迟的区域更新已启动，并且相关联的 [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) 会在此调用的 [PartySetTextToSpeechProfileCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partysettexttospeechprofilecompletedstatechange) 完成之前提供。

## Requirements

**Header:** Party.h

## See also

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


## Related topics

- [PartyLocalChatControl::PopulateAvailableTextToSpeechProfiles](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_populateavailabletexttospeechprofiles.md)
- [PartyLocalChatControl::GetTextToSpeechProfile](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_gettexttospeechprofile.md)
- [PartyTextToSpeechProfile](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyTextToSpeechProfile/partytexttospeechprofile.md)
- [PartyLocalChatControl::SynthesizeTextToSpeech](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_synthesizetexttospeech.md)
- [PartySynthesizeTextToSpeechType](/zh-CN/services/playfab/multiplayer/networking/reference/enums/partysynthesizetexttospeechtype.md)