一、通用参数的差异
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 参数 | 迁移建议 |
| 机器人信息 | UserIdUserSigMaxIdleTime | UserIdUserSigMaxIdleTime | 保持原始参数设置。 |
| 回调转录翻译结果 | IMAdminUserIdIMAdminUserSig | SendCustomMode | 推荐通过设置 SendCustomMode 为1来使用自定义数据方式进行回调。若需要继续使用自定义消息方式回调可设置 SendCustomMode 为 2。 |
| 订阅用户的管理 | TranscriptionModeTargetUserIdTargetUserIdList | SubscribeListUnSubscribeList | 推荐通过 SubscribeList 设置要订阅的用户,通过 UnSubscribeList 设置不订阅的用户。不设置这两个参数时默认订阅所有用户。使用黑白名单时,同一个用户同时在黑白名单时,以黑名单为主。 |
| 声纹、断句配置 | VoicePrintTurnDetection | 不支持 | 不设置这两个参数。 |
三、语音识别参数的差异
对于语音识别(ASR) 功能,1.0版本使用 RecognizeConfig 参数作为语音识别的配置参数,2.0版本使用 AsrParam 参数作为语音识别的配置参数,具体的配置子项参数名完全一致。
注意:2.0版本模糊识别支持的语言仅支持高级版 ASR 语种,详情参见 高级版语种列表。
四、翻译参数的差异
| 配置项 | 旧版本 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 | 迁移建议 |
| 输入参数 | TaskIdSdkAppIdSessionId | TaskIdSdkAppId | 只用填写 TaskId 和 SdkAppId 参数 |
| 返回参数 | StartTimeStatusTaskIdSessionId | StartTimeStatusTaskId | – |
六、停止任务的差异
相较于 1.0 版本,2.0版本停止任务需要填写 SdkAppId 参数,其余用法保持一致。