视频管理
获取单个视频记录
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为成功,其他值为失败