视频管理

获取单个视频记录

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为成功,其他值为失败 
Copyright Talkfun all right reserved,powered by Gitbook修订时间: 2021-08-17 16:03:59

results matching ""

    No results matching ""