接口描述
描述:
查询单个云录制的智能发言人列表,支持 OAuth 2.0鉴权调用,仅支持授权用户为商业版、企业版、教育版。
当该录制文件未开启相关智能化功能或内容处于生成中状态时,不支持调用。
请求方法:GET
接口请求域名:
https://api.meeting.qq.com/v1/smart/speakers
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
operator_id | 是 | String | 操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 |
operator_id_type | 是 | Integer | 操作者 ID 类型: 1:userid 2:openid |
record_file_id | 是 | String | 录制文件 ID,录制列表接口会返回该 ID。 |
pwd | 否 | String | 录制文件的访问密码,非必填。 |
page | 是 | Integer | 页码,从 1 开始。 |
page_size | 是 | Integer | 返回数量,最大 50。 |
输出参数
参数名称 | 参数类型 | 参数描述 |
total_count | Integer | 发言人总数。 |
speaker_list | SpeakerList 对象数组 | 录制文件的智能发言人列表。 |
SpeakerList 对象
参数名称 | 参数类型 | 参数描述 |
speaker_id_type | Integer | 发言人ID类型:
1:userid
2:openid
6:temp_id(临时 ID,上传的文件无法映射到 userid,故仅在当前录制发言人中代表唯一用户标识) |
speaker_id | String | 发言人 ID。speaker_id 必须与 speaker_id_type 配合使用。根据 speaker_id_type 的值,speaker_id 代表不同类型。 |
speaker_name | String | 发言人名称,返回 base64 编码后的结果。 |
total_time | String | 发言总时长,单位毫秒。 |
speaker_time | SpeakerTime对象数组 | 录制文件某个具体发言人的发言时间段,以对象数组形式返回。 |
SpeakerTime 对象
参数名称 | 参数类型 | 参数描述 |
sid | String | 发言语句 ID |
start_time | String | 发言开始时间,单位毫秒。 |
end_time | String | 发言结束时间,单位毫秒。 |
示例
输入示例
https://api.meeting.qq.com/v1/smart/speakers?record_file_id=178xxxxxxxxx281&operator_id_type=1&operator_id=xxxxx&page_size=50&page=1
输出示例
{"speaker_list": [{"speaker_id": "xxxxxxxx","speaker_id_type": 6,"speaker_name": "Ym9iZ2xxxxxxxxxxxxxazoik=","total_time": 96180,"speaker_time": [{"start_time": "7339","end_time": "23719","sid": "0"},{"start_time": "111759","end_time": "112419","sid": "6"},{"start_time": "206939","end_time": "274169","sid": "7"},{"start_time": "295079","end_time": "307559","sid": "23"},{"start_time": "329399","end_time": "371089","sid": "26"},{"start_time": "384019","end_time": "447519","sid": "35"},{"start_time": "490979","end_time": "494199","sid": "45"}]}],"total_count": 1}