Syntax
Parameters
options PartyVoiceChatTranscriptionOptions
与语音聊天转录关联的选项,例如哪些聊天控件应为本地聊天控件生成转录,以及这些转录是否应翻译为本地聊天控件的语言。
asyncIdentifier void*optional 可选的、应用定义的指针大小上下文值,可用于将完成状态更改与此调用关联。
Return value
PartyError 如果设置转录选项的异步操作已开始,则返回c_partyErrorSuccess;否则返回错误代码。如果此方法失败,则不会生成相关的状态更改。可通过 PartyManager::GetErrorMessage() 检索错误代码的可读形式。
Remarks
转录是生成表示语音聊天中所说短语的字符串的过程。通过options 指定的选项指定哪些聊天控件应生成这些转录字符串,随后通过 PartyVoiceChatTranscriptionReceivedStateChange 提供给本地聊天控件。只有通过 PartyLocalDevice::CreateChatControl() 配置为使用支持转录的语言的聊天控件才会提供转录。
语音转文本转录功能在内部使用可用区域和延迟测量估计来优化服务使用。如果使用 PartyOption::RegionUpdateConfiguration 选项配置了 PartyRegionUpdateMode::Deferred 更新模式,则检索可用区域集及测量到它们的连接质量可能尚未启动,或上次更新可能已超过配置的刷新间隔时限。如果本地设备当前未连接或正在连接到任何网络,并且应用指定了包含 PartyVoiceChatTranscriptionOptions::TranscribeSelfRegardlessOfNetworkState 的选项标志,则 SetTranscriptionOptions() 可确保任何延迟的区域更新已启动,并且相关联的 PartyRegionsChangedStateChange 会在此调用的 PartySetTranscriptionOptionsCompletedStateChange 完成之前提供。
