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

> 配置与此聊天控件的语音聊天音频关联的转录选项。

配置与此聊天控件的语音聊天音频关联的转录选项。

## Syntax

```cpp theme={null}
PartyError SetTranscriptionOptions(  
    PartyVoiceChatTranscriptionOptions options,  
    void* asyncIdentifier  
)  
```

### Parameters

**`options`**   [PartyVoiceChatTranscriptionOptions](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions)

与语音聊天转录关联的选项，例如哪些聊天控件应为本地聊天控件生成转录，以及这些转录是否应翻译为本地聊天控件的语言。

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

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

### Return value

PartyError

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

## Remarks

转录是生成表示语音聊天中所说短语的字符串的过程。通过 `options` 指定的选项指定哪些聊天控件应生成这些转录字符串，随后通过 [PartyVoiceChatTranscriptionReceivedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyvoicechattranscriptionreceivedstatechange) 提供给本地聊天控件。<br /><br /> 只有通过 [PartyLocalDevice::CreateChatControl()](/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol) 配置为使用支持转录的语言的聊天控件才会提供转录。   <br /><br /> 语音转文本转录功能在内部使用可用区域和延迟测量估计来优化服务使用。如果使用 [PartyOption::RegionUpdateConfiguration](/services/playfab/multiplayer/networking/reference/enums/partyoption) 选项配置了 [PartyRegionUpdateMode::Deferred](/services/playfab/multiplayer/networking/reference/enums/partyregionupdatemode) 更新模式，则检索可用区域集及测量到它们的连接质量可能尚未启动，或上次更新可能已超过配置的刷新间隔时限。如果本地设备当前未连接或正在连接到任何网络，并且应用指定了包含 [PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState](/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions) 的选项标志，则 SetTranscriptionOptions() 可确保任何延迟的区域更新已启动，并且相关联的 [PartyRegionsChangedStateChange](/services/playfab/multiplayer/networking/reference/structs/partyregionschangedstatechange) 会在此调用的 [PartySetTranscriptionOptionsCompletedStateChange](/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange) 完成之前提供。

## Requirements

**Header:** Party.h

## See also

[PartyLocalChatControl](/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/partylocalchatcontrol)


## Related topics

- [PartyLocalDevice::CreateChatControl](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalDevice/methods/partylocaldevice_createchatcontrol.md)
- [PartyLocalChatControl::GetLanguage](/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalChatControl/methods/partylocalchatcontrol_getlanguage.md)
- [PartyVoiceChatTranscriptionOptions](/zh-CN/services/playfab/multiplayer/networking/reference/enums/partyvoicechattranscriptionoptions.md)
- [PartySetTranscriptionOptionsCompletedStateChange](/zh-CN/services/playfab/multiplayer/networking/reference/structs/partysettranscriptionoptionscompletedstatechange.md)
- [PartyVoiceChatTranscriptionReceivedStateChange](/zh-CN/services/playfab/multiplayer/networking/reference/structs/partyvoicechattranscriptionreceivedstatechange.md)