TRTC AI 转录/翻译 2.0 对 1.0 的使用配置和回调方式进行了优化。若需要升级到 2.0 版本,请参见本文对于接入传参的差异说明。
发起任务的差异
通用参数的差异
2.0版本去掉了 SessionId 参数,可以不用传入 SessionId。
转录机器人参数的差异
2.0版本的机器人进房参数更简洁。差异如下:
回调转录翻译结果的方式:2.0 版本通过 SendCustomMode 参数控制回调转录翻译结果的方式,推荐设置 SendCustomMode 为 1 以使用自定义数据的方式回调,自定义数据回调方式相较于 1.0 版本自定义消息方式可靠性更高。
订阅用户的管理方式:1.0版本使用 TranscriptionMode、TargetUserId、TargetUserIdList 这三个参数管理订阅的用户,2.0 版本可以使用 SubscribeList 和 UnSubscribeList 参数通过订阅黑白名单的机制来管理订阅用户。
配置项 | 旧版本 1.0 RecognizeConfig 参数 | 新版本 2.0 AsrParam 参数 | 迁移建议 |
机器人信息 | UserId UserSig MaxIdleTime | UserId UserSig MaxIdleTime | 保持原始参数设置。 |
回调转录翻译结果 | IMAdminUserId IMAdminUserSig | SendCustomMode | 推荐通过设置 SendCustomMode 为1来使用自定义数据方式进行回调。若需要继续使用自定义消息方式回调可设置 SendCustomMode 为 2。 |
订阅用户的管理 | TranscriptionMode TargetUserId TargetUserIdList | SubscribeList UnSubscribeList | 推荐通过 SubscribeList 设置要订阅的用户,通过 UnSubscribeList 设置不订阅的用户。 不设置这两个参数时默认订阅所有用户。使用黑白名单时,同一个用户同时在黑白名单时,以黑名单为主。 |
声纹、断句配置 | VoicePrint TurnDetection | 不支持 | 不设置这两个参数。 |
语音识别参数的差异
对于语音识别(ASR) 功能,1.0版本使用 RecognizeConfig 参数作为语音识别的配置参数,2.0版本使用 AsrParam 参数作为语音识别的配置参数,具体的配置子项参数名完全一致。
翻译参数的差异
配置项 | 旧版本 1.0 TranslationConfig 参数 | 新版本 2.0 TranslationParam 参数 | 迁移建议 |
翻译目标语言 | TargetLanguages | TargetLang | 使用 TargetLang 配置项替代 TargetLanguages 配置项。 |
TTS 配置 | TTSConfig | 不支持 | 如果需要使用 TTS 实现翻译同声传译的请继续使用 1.0 版本接口。 |
翻译术语表 | Terminology | Terminology | - |
查询任务的差异
2.0版本查询转录任务时只用填写 SdkAppId 和 TaskId,返回结果是任务的开始时间和状态。
参数 | 旧版本 1.0 DescribeAITranscription | 新版本 2.0 DescribeCloudTranscription | 迁移建议 |
输入参数 | TaskId SdkAppId SessionId | TaskId SdkAppId | 只用填写 TaskId 和 SdkAppId 参数 |
返回参数 | StartTime Status TaskId SessionId | StartTime Status TaskId | - |
停止任务的差异
相较于 1.0 版本,2.0版本停止任务需要填写 SdkAppId 参数,其余用法保持一致。