更新时间:2025-01-02 GMT+08:00
分享

设置传译组

功能介绍

主持人通过该接口设置传译组,每个传译组支持两种语言,传译组内支持多个传译员。只支持全量更新。

调试

您可以在API Explorer中调试该接口。

URI

PUT /v1/mmc/control/conferences/interpreterGroup

表1 Query参数

参数

是否必选

参数类型

描述

conferenceID

String

会议ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Conference-Authorization

String

会控Token,通过获取会控token接口获得。

表3 请求Body参数

参数

是否必选

参数类型

描述

interpreterGroups

List<InterpreterGroupInfo>

传译员列表。

表4 请求InterpreterGroupInfo参数

参数

是否必选

参数类型

描述

groupID

String

传译组序号。

groupName

String

传译组名称。

firstLanguage

String

传译组支持翻译的第一种语言(en,zh等)。

secondLanguage

String

传译组支持翻译的第二种语言。

groupType

String

传译组类型,MANUAL:人工传译,AI:AI传译。默认MANUAL。

interpreters

List<InterpreterInfo>

传译员列表。

表5 请求InterpreterInfo参数

参数

是否必选

参数类型

描述

loginAccount

String

用户登录账号,可以是账号、手机、邮箱其中一个(loginAccount和userID二选一)。

userID

String

用户id(loginAccount和userID二选一)。

callNumber

String

用户呼叫号码。

name

String

用户名称。

interpreterType

String

传译员类型,MANUAL:人工传译,AI:AI传译。默认MANUAL。

aiDigitalInfo

InterpreterAiDigitalInfo object

AI传译员场景下使用的数字资产信息。

interpreterId

String

传译员序号,AI传译组下传译员唯一标识。

表6 InterpreterAiDigitalInfo参数

参数

是否必选

参数类型

描述

type

String

数字资产类型:PUBLIC(系统公共)、PRIVATE(企业专用账号绑定)、LOCAL(企业本地通用)。

digitalAccount

String

AI传译员场景下绑定使用的数字资产ID(数字人或TTS音色)。

digitalName

String

数字资产名称。

presenterAccount

String

专用数字资产绑定的发言人登录账号,翻译对象非匿名必填。

presenterRealNameAccount

String

专用数字资产绑定的发言人登录账号(匿名时),翻译对象匿名必填。

presenterName

String

专用数字资产绑定的发言人名称。

presenterUserID

String

发言人用户的userUUID。

localConfId

String

本地会议的会议id(第三方对接参数),数字资产为LOCAL时必填。

localConfAddr

String

本地会议对接地址或域名。

localAuthInfo

String

本地会议对接鉴权信息。

localNeedProxy

boolean

true:需要代理 false:不需要代理。

localAuthUrl

String

本地会议获取动态鉴权信息Url。

localAuthAppId

String

本地会议鉴权AppId。

表7 状态码说明

HTTP状态码

描述

200

操作成功。

400

参数异常。

401

未鉴权或鉴权失败。

403

权限受限。

500

服务端异常。

响应参数

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

结果描述

请求示例

PUT https://{endpoint}/v1/mmc/control/conferences/interpreterGroup?conferenceID=984178192

{
  "interpreterGroups": [{
    "groupID": "f89d1070afdc41ff1c6496e3f58ccee0",
    "firstLanguage": "zh",
    "secondLanguage": "en",
    "interpreters": [{
      "loginAccount": "p-80852a66fca94c69aa3d344ec9452171"
    }]
  }]
}

响应示例

状态码: 400

{
  "error_code" : "MMC.111072065",
  "error_msg" : "CONF_NOT_FOUND_OR_AUTH_FAILED"
}

错误码

当您使用华为云会议服务端API时,如果遇到“MMC”或者“USG”开头的错误码,请参考华为云API错误中心

相关文档