创建录制任务

最近更新时间:2018-11-27 16:45:22

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

}