将点播视频添加到视频库
接口描述
接口URL
请求方式
接口约束
1、接口同时支持HTTP 、HTTPS ,建议使用HTTPS 确保接口安全,接口调用有频率限制,详细请查看
2、跨频道设置三分屏回放,需要调用修改视频信息接口将vid对应视频tag修改为:频道号|ppt,如:2566989|ppt
请求参数描述
timestamp
true
Long
当前13位毫秒级时间戳,3分钟内有效
sign
true
String
签名,为32位大写的MD5值,生成签名的appSecret密钥作为通信数据安全的关键信息,严禁保存在客户端直接使用,所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据
【详见签名生成规则】
channelId
true
String
频道号
setAsDefault
false
String
添加到视频库列表中的位置,默认为N Y:回放列表中置顶 N:回放列表中置底
listType
false
String
列表类型,普通直播场景默认为vod,三分屏默认为playback playback:回放列表 vod:点播列表
示例
表单参数:
响应参数描述
data字段描述
videoId
String
直播系统生成的id
videoPoolId
String
点播视频vid
userId
String
POLYV用户ID,和保利威官网一致,获取路径:官网->登录->直播(开发设置)
channelId
String
回放视频对应的直播频道号
title
String
视频标题
firstImage
String
视频首图
duration
String
视频长度,格式为HH:mm:ss
myBr
String
默认视频的播放清晰度 1:流畅 2:高清 3:超清
qid
String
访客信息收集id
seed
Integer
视频加密状态 1:加密 0:非加密
ordertime
Integer
关联点播视频的排序字段
createdTime
Long
添加为回放视频的日期,13位毫秒级时间戳
lastModified
Long
视频最后修改日期,13位毫秒级时间戳
rank
Integer
排序值,值越大优先级越高
asDefault
String
是否为默认播放视频 Y:播放 N:不播放
url
String
视频播放地址,注:如果视频为加密视频,则此地址无法访问
channelSessionId
String
用于PPT请求数据,与PPT直播的回放相关,普通直播回放值为null
status
String
关联点播视频的状态
fileUrl
String
视频地址
fileId
String
回放视频转存前的暂存fileId
startTime
String
直播开始时间,格式为:yyyyMMddHHmmss
liveType
String
直播类型 alone:活动直播 ppt:三分屏 topclass:大班课 seminar:研讨会
width
Integer
视频宽度
height
Integer
视频高度
origin
String
转存文件来源 manual:手动录制 auto:自动录制 merge:合并 clip:裁剪
callbackUrl
String
转存视频时设置的回调地址
errorCount
Integer
处理失败的次数
lang
String
语言类型,默认为中文 zh_CN:中文 EN:英文
videoIdEN
String
英文回放videoId
enFileUrl
String
英文回放文件地址
mergeInfo
String
视频合并信息
Java请求示例
快速接入基础代码请下载相关依赖源码, 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。
强烈建议您使用直播Java SDK完成API的功能对接,直播Java SDK 对API调用逻辑、异常处理、数据签名、HTTP请求线程池进行了统一封装和优化。
响应示例
系统全局错误说明详见全局错误说明
成功示例
异常示例
Last updated
Was this helpful?