创建视频
由于视频文件的存储是在对象存储,而管理信息在点播服务,因此我们需要3步来进行文件上传。
1、初始化上传,在此步骤需要将所有的业务管理信息发送到点播服务中创建视频文件接口,接口成功之后会返回分片上传的地址列表。
2、将视频文件片上传到上述的接口中。
3、调用点播服务完成上传视频接口。
调用了该接口但未调用完成上传视频接口,系统会在数据库中存入这些业务信息(以及一些中间信息,例如uploadId),不过由于这条视频信息还处于UPLOADING
的状态,因此,在除了删除视频外的其他接口,均不会对这些视频造成影响。例如在提交任务接口中,甚至会返回找不到该视频的错误。
/video/create
{
/**
* 必填参数,视频的名称
*/
"name": "",
/**
* 可选参数,视频存储的区域,请保证您开通了该区域的存储,当不填写时则是使用默认资源池。
*/
"regionCode": "",
/**
* 可选参数,视频简介.
*/
"remark": "",
/**
* 可选参数,视频标签.
*/
"tags": ["爱情片", "武侠片"]
/**
* 必填参数,文件的基本信息,后台会根据这些信息来计算各个分片的上传地址。
*/
"fileInfo": {
/**
* 可选参数,当该参数传入之后,当视频上传合并完成之后会对上传的视频进行 md5 校验。校验失败会返回上传失败。如果为空则不检查。
*/
"md5": "",
/**
* 必填参数,文件大小,单位为 byte
*/
"fileSize": 1024000,
/**
* 可选参数,分片大小,单位为 最小为 5M,如果不填写,默认为 5M
*/
"partSize": 1024 * 5
}
}
{
/***
* 本次请求的结果码。
* 0: 创建任务成功。
* 400: 传入参数错误。
* 500: 系统发生错误。
*/
"code": 0,
/***
* 错误文本信息,创建成功时,为空字符串。
*/
"message": "",
/***
* 执行结果数据
*/
"data" : {
/**
* 视频的 id,仅可用在 `完成上传视频` 接口以及 `删除视频` 接口。
*/
"videoId": "34c71dba-f280-4f5e-a05f-f4daed83xxxx",
"uploadUrls": ["http://www.a.com/uploadPart?partNum=1signature=xxxxxx",
"http://www.a.com/uploadPart?partNum=2signature=xxxxxx"]
}
}