1. 接口描述
域名:live.api.qcloud.com
接口名: CreateRecord
说明:
注意:
调用接口超时设置应大于3秒,小于3秒重试以及频繁调用都有可能产生重复录制任务。
录制规则:
(1)任务时间到达时,即启动录制任务,直至直播结束。
(2)录播按时间进行分片,最大大小为0.5小时。
(3)录播时,发生断流,则停止录播生成一个分片。
断流恢复后启动新的录播分片任务,重复(1)(2)(3)的过程,直至整个任务结束。
录制分片请求 url 格式:
http://(点播bizid).vod.myqcloud.com/(vid).f0.flv
或直接到云点播页面查看即可。2. 输入参数
参数名称 | 必选 | 类型 | 描述 |
channelId | 是 | String | 频道 ID。 |
startTime | 是 | String | 开始时间,中国标准时间,需要 URLEncode。如 2017-01-01 10:10:01,编码为:2017-01-01+10%3a10%3a01。 |
endTime | 是 | String | 结束时间,中国标准时间,需要 URLEncode。如 2017-01-01 10:30:01,编码为:2017-01-01+10%3a30%3a01。 |
tapeType | 是 | Int | 是否开启实时视频录制。1:开启;0:关闭,推荐使用实时视频录制。 a. 实时视频录制创建成功依赖主播活跃推流,调用接口成功则同步开始录制,并忽略任务开始时间参数。 b. 实时视频录制任务时长支持最大为30分钟,如果传入任务结束时间与当前时间差大于30分钟,则按30分钟计算。录制时长建议控制在5分钟以内。 c. 如果关闭实时录制,则需要传入任务开始时间参数,且结束时间与开始时间差不大于1天。 |
3. 输出参数
参数名称 | 类型 | 描述 |
code | Int | 错误码,0:成功,其他值:失败 |
message | String | 错误信息 |
task_id | Int | 任务 ID,64位无符整形 |
4. 示例
输入1
http://domain/v2/index.php?Action=CreateRecord&channelId=123&tapeType=1&endTime=2016-01-21+12%3a00%3a00&公共请求参数
输出1
{"code": 0,"message": "","task_id": 1}