生成回放
生成回放
基本信息
Path: /api/v2/vod
接口描述:
提交生成回放任务,开始异步处理,结果需等待事件回调。
结果请监听回调事件:生成回放完成
请求参数
Query
| 参数名称 | 类型 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| action | string | 是 | SubmitCreateRecordTasks | 固定参数,SubmitCreateRecordTasks |
| app_id | string | 是 | f4efa787 | app_id |
| stream_id | string | 是 | lss_893f81e9 | 直播流ID,一般即为房间ID |
| start_time | string | 是 | 2019-01-01 12:00:00 | 开始时间,格式如2019-01-01 12:00:00 |
| end_time | string | 是 | 2019-01-01 16:00:00 | 结束时间,格式如2019-01-01 13:00:00 |
| instant | int | 否 | 生成回放异步速度: 0:默认,等待视频同步一定时间后,开始异步生成 1:为不等待,直接开始异步生成 |
|
| drop_sections | json | 否 | 参考下表drop_sections参数说明 | 要剔除的时间段 |
drop_sections 参数
| 参数名称 | 类型 | 含义 |
|---|---|---|
| drop_start | date | 要剔除时间段的开始时间点 |
| drop_end | date | 要剔除时间段的结束时间点 |
[
{
"drop_start": "2017-05-11 00:15:20", #要剔除时间段的开始时间点
"drop_end": "2017-05-12 00:15:20" #要剔除时间段的结束时间点
},
{
"drop_start": "2018-10-09 18:10:20",
"drop_end": "2018-10-09 18:20:20"
}
]
出参
| 参数 | 类型 | 是否必选 | 含义 |
|---|---|---|---|
| vod_id | string | 是 | 生成点播ID |
| task_id | string | 是 | 回放任务ID |
返回数据
{
"msg": "task pending",
"code": 200,
"request_id": "B36A562C-BBE7-4B16-9F4A-C7A03AC9D6E2",
"data": {
"vod_id": "d89f664",
"task_id": "80f6d1ae-89e9-4011-9a44-3e1cbc37bc73"
}
}
