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
}
