创建录制任务

最近更新时间:2019-08-09 16:22:25

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

}