PartyLocalChatControl::SetTranscriptionOptions

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

语法

PartyError SetTranscriptionOptions(  
    PartyVoiceChatTranscriptionOptions options,  
    void* asyncIdentifier  
)

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

asyncIdentifier void*
可选

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

PartyError

如果设置转录选项的异步操作已开始，则为 c_partyErrorSuccess，否则为错误代码。如果此方法失败，则不会生成任何相关的状态更改。可通过 PartyManager::GetErrorMessage() 检索错误代码的可读形式。

转录是生成代表语音聊天中口语短语的字符串的过程。通过 options 指定的选项指定了应该生成这些转录字符串的聊天控件，这些字符串随后通过 PartyVoiceChatTranscriptionReceivedStateChange 提供给本地聊天控件。

只有通过 PartyLocalDevice::CreateChatControl() 配置为使用支持转写的语言的聊天控件，才会提供转写。

语音转文本听录功能在内部使用可用区域和延迟度量估计来优化服务使用情况。如果使用 PartyOption::RegionUpdateConfiguration 选项来配置 PartyRegionUpdateMode::D eferred的更新模式，则检索可用区域集并测量它们的连接质量可能尚未启动，或者上次更新可能已超过配置的刷新间隔期限。如果本地设备当前未连接或未连接到任何网络，并且应用程序指定了包含 PartyVoiceChatTranscriptionOptions::TranscribeSelfRetribulessOfNetworkState 的选项标志，则 SetTranscriptionOptions() 确保已启动任何延迟的区域更新，并且在此调用的 PartySetTranscriptionOptionsCompletedStateChange 完成之前，会提供关联的 PartyRegionsChangedStateChange。

标题： Party.h