视频管理
获取单个视频记录
api名称:video.get,SDK对应方法:videoGet
| 名称 |
类型 |
必选 |
描述 |
| videoId |
string |
Y |
视频ID |
| expire |
int |
Y |
返回播放地址的有效时间,默认:3600秒。最小值为 60s,最大值为 720d。 |
返回参数data说明:
| 名称 |
类型 |
描述 |
| videoId |
string |
视频ID |
| title |
string |
视频标题 |
| duration |
string |
视频时长(单位:秒) |
| status |
string |
状态:0为处理完成,1为处理中,3为处理失败 |
| videoUrl |
string |
视频地址 |
| videoPreviewUrl |
string |
视频预览地址,源视频前5分钟的内容 |
| thumb |
string |
缩略图地址 |
| thumb_720x540 |
string |
720x540尺寸缩略图地址 |
| filesize |
string |
视频文件大小 |
| progress |
int |
视频转换进度(百分比),转换完后1小时左右会清除此状态,返回false |
批量获取视频记录
api名称:video.getBatch,SDK对应方法:videoGetBatch
| 名称 |
类型 |
必选 |
描述 |
| videoIds |
array |
Y |
视频ID列表不超过50个 |
| expire |
int |
Y |
返回的播放地址的有效时间,默认:3600秒。最小值为 60s,最大值为 720d。 |
返回参数data说明:`二维数组`
| 名称 |
类型 |
描述 |
| videoId |
string |
视频ID |
| title |
string |
视频标题 |
| duration |
string |
视频时长(单位:秒) |
| status |
string |
状态:0为处理完成,1为处理中,3为处理失败 |
| videoUrl |
string |
视频地址 |
| videoPreviewUrl |
string |
视频预览地址,源视频前5分钟的内容 |
| thumb |
string |
缩略图地址 |
| thumb_720x540 |
string |
720x540尺寸缩略图地址 |
| filesize |
string |
视频文件大小 |
| progress |
int |
视频转换进度(百分比),转换完后1小时左右会清除此状态,返回false |
| md5 |
string |
视频md5值 |
获取视频列表
api名称:video.list,SDK对应方法:videoList
| 名称 |
类型 |
必选 |
描述 |
| page |
int |
Y |
页码,每页20条记录 |
| expire |
int |
Y |
返回的播放地址的有效时间,默认:3600秒。最小值为 60s,最大值为 720d。 |
返回参数data说明:`二维数组`
| 名称 |
类型 |
描述 |
| videoId |
string |
视频ID |
| title |
string |
视频标题 |
| duration |
string |
视频时长(单位:秒) |
| status |
string |
状态:0为处理完成,1为处理中,3为处理失败 |
| videoUrl |
string |
视频地址 |
| videoPreviewUrl |
string |
视频预览地址,源视频前5分钟的内容 |
| thumb |
string |
缩略图地址 |
| thumb_720x540 |
string |
720x540尺寸缩略图地址 |
| filesize |
string |
视频文件大小 |
| progress |
int |
视频转换进度(百分比),转换完后1小时左右会清除此状态,返回false |
| md5 |
string |
视频md5值 |
删除视频
api名称:video.delete,SDK对应方法:videoDelete
| 名称 |
类型 |
必选 |
描述 |
| videoId |
string |
Y |
视频ID |
返回参数说明:code=0为成功,其他值为失败
获取上传地址
api名称:video.getUploadUrl,SDK对应方法:videoGetUploadUrl
| 名称 |
类型 |
必选 |
描述 |
| account |
string |
Y |
上传者帐号,最长32位 |
| accountType |
int |
Y |
账号类型,1为欢拓帐号,2为合作方帐号 |
| title |
string |
Y |
视频标题 |
| md5 |
string |
N |
视频文件MD5 |
| options |
array |
N |
可选参数 |
| options.nickname |
string |
Y |
主播昵称,如果是新主播,需要传此参数用来自动创建主播;若不是则可不传 |
| options.accountIntro |
string |
N |
主播简介 |
| options.departmentID |
int |
N |
主播部门,关联主播的部门,如果创建课程,则课程也绑定此部门。如果课程要绑定不同的部门,请使用不同的主播帐号。 |
| options.course |
array |
N |
创建课程的参数,如果不创建或稍后创建,请留空。 |
| options.course.start_time |
string |
N |
课程的开始时间,如果要创建课程,不要留空;如果要创建伪直播,此值应大于当前时间;如果只要视频回放,应小于当前时间。 |
| options.course.end_time |
string |
N |
课程的结束时间,如果创建课程,留空时为视频回放。 |
返回参数data说明(新视频):
| 名称 |
类型 |
描述 |
| resumeUploadUrl |
string |
分片上传的上传地址 |
| uploadUrl |
string |
上传地址 |
| chunkListUrl |
string |
分片上传查询地址,结合SDK使用 |
| field |
string |
上传的文件参数名 |
返回参数data说明(以前上传过的视频,返回code为`1281`的情况):
| 名称 |
类型 |
描述 |
| bid |
int |
欢拓主播ID |
| videoId |
int |
视频ID |
| duration |
int |
视频长度,单位秒 |
| filesize |
int |
视频大小,单位字节 |
| url |
string |
视频临时观看地址 |
| course_id |
int |
如果传了options.course.start_time的情况下,如果创建课程成功,会有返回。(个别情况可能会创建失败,如课程时间冲突) |
上传视频
调用sdk的videoUpload(整个文件单次上传)/videoSegmentUpload(文件分片上传)方法(支持的格式:mp4,flv,avi,mov,mkv,单个文件>=200M时,必须用分片上传)
| 名称 |
类型 |
必选 |
描述 |
| fileName |
string |
Y |
要上传的本地路径文件 |
| account |
string |
Y |
上传者帐号ID |
| accountType |
string |
Y |
账号类型,1为欢拓帐号,2为合作方帐号 |
| title |
string |
Y |
视频标题 |
| nickname |
string |
Y |
上传者昵称 |
| accountIntro |
string |
Y |
上传者简介 |
| course |
array |
N |
创建课程的参数,如果不创建或稍后创建,请留空。 |
| course.start_time |
string |
N |
课程的开始时间,如果要创建课程,不要留空;如果要创建伪直播,此值应大于当前时间;如果只要视频回放,应小于当前时间。 |
| course.end_time |
string |
N |
课程的结束时间,如果创建课程,留空时为视频回放。 |
返回参数data说明:
| 名称 |
类型 |
描述 |
| videoId |
string |
视频ID |
| course_id |
int |
课程ID(如果接口有传创建课程的参数) |
| url |
string |
播放页地址 |
网页上传
获取上传地址,参考`video.getUploadUrl`
参考: [网页上传](sdk-uploader.md)
更新视频
api名称:video.update,SDK对应方法:videoUpdate
| 名称 |
类型 |
必选 |
描述 |
| videoId |
int |
Y |
视频ID |
| title |
string |
Y |
视频标题 |
返回参数说明:code=0为成功,其他值为失败