Info Service
Last updated
Was this helpful?
Last updated
Was this helpful?
1、接口调用有频率限制,,调用常见异常,
1、请求正确,返回VodGetVideoResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
videoId
true
String
视频ID【对应api文档的vid字段】
swfLink
String
返回flash链接【对应api文档的swf_link字段】
tag
String
视频标签
mp4
String
MP4源文件
playerWidth
Integer
视频宽度【对应api文档的playerwidth字段】
title
String
视频标题
duration
String
视频时长,如:00:00:48
filesize
Long[]
编码后各个清晰度视频的文件大小,类型为array
firstImage
String
视频首图【对应api文档的first_image字段】
times
Integer
播放次数
context
String
视频描述
originalDefinition
String
最佳分辨率,如:1280x720【对应api文档的original_definition字段】
images
String[]
视频截图
playerHeight
Integer
视频高度【对应api文档的playerheight字段】
uploadTime
Date
上传时间,格式:yyyy-MM-dd HH:mm:ss【对应api文档的ptime字段】
videoId
String
视频id【对应api文档的vid字段】
previewVideoId
String
预览视频id【对应api文档的previewVid字段】
categoryId
String
分类id, 如1为根目录【对应api文档的cataid字段】
defaultVideo
String
用户默认播放视频【对应api文档的default_video字段】
df
Integer
视频码率数
SDFlv
String
流畅码率flv格式视频地址【对应api文档的flv1字段】
HDFlv
String
高清码率flv格式视频地址【对应api文档的flv2字段】
FHDFlv
String
超清码率flv格式视频地址【对应api文档的flv3字段】
SDMp4
String
流畅码率mp4格式视频地址【对应api文档的mp4_1字段】
HDmp4
String
高清码率mp4格式视频地址【对应api文档的mp4_2字段】
FHDmp4
String
超清码率mp4格式视频地址【对应api文档的mp4_3字段】
hls
String[]
索引文件,记录每个清晰度的m3u8的链接,数组第一个为流畅链接,第二个为高清,第三个为超清,数组长度为1-3
SDHls
String
流畅清晰度的m3u8
HDHls
String
高清清晰度的m3u8
FHDHls
String
超清清晰度的m3u8
imagesBig
String[]
视频截图大图地址【对应api文档的images_b字段】
seed
Integer
加密视频为1,非加密为0
status
Integer
视频状态:60/61已发布;10等待编码;20正在编码;50等待审核;51审核不通过;-1已删除;
keepSource
Integer
是否为源文件,否:0,是:1【对应api文档的keepsource字段】
uploader
Uploader
hlsLevel
String
加密等级 open:非授权加密 web:web授权 app:app授权 wxa_app:小程序授权
categoryName
String
分类名称【对应api文档的cataname字段】
imageUrls
Array
视频截图小图url
sourceFileSize
String
源视频文件大小,单位为:byte【对应api文档的source_filesize字段】
md5CheckSum
String
上传到POLYV云平台的视频源文件的MD5值,可以用来校验是否上传错误或完整【对应api文档的md5checksum字段】
String
上传者邮箱
name
String
上传者名称
role
String
上传者角色,如管理员,上传者,主账号
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
videoId
true
String
视频ID【对应api文档的vid字段】
true为开关开启,false为开关关闭
2、当传了videoIds时,按照videoIds查询;当仅传categoryIds时,按照categoryIds查询;videoIds和categoryIds不能同时为空;同时传以videoIds为准
1、请求正确,返回VodGetVideoSizeResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
videoIds
true
String
多个视频ID(英文逗号分割 状态为半角),例如 1b8be3,239c2e【对应api文档的vids字段】
categoryIds
false
String
多个分类ID(逗号分割),当传了vids时,按照vids查询;当仅传cataid时,按照cataid查询;vids和cataid不能同时为空【对应api文档的cataid字段】
返回对象是List<VodGetVideoSizeResponse>,VodGetVideoSizeResponse具体元素内容如下:
categoryId
String
分类ID【对应api文档的cataid字段】
videos
Array
videoId
String
视频ID【对应api文档的vid字段】
duration
String
时长,格式为hh:mm:ss。例如 00:03:11
filesize1
Long
编码后码率1FLV的大小,单位为Bytes:字节
filesize2
Long
编码后码率2FLV的大小,单位为Bytes:字节
filesize3
Long
编码后码率3FLV的大小,单位为Bytes:字节
1、请求正确,返回VodGetWeChatShareVideoInfoResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
videoId
true
String
视频ID【对应api文档的vid字段】
videoCoverImg
String
视频封面图
videoTitle
String
视频微信分享标题
videoDesc
String
视频描述
videoIcon
String
视频图标
originalPlayTimes
Integer
初始播放量
originalLikeNum
Integer
初始点赞量
1、请求正确,返回Integer对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
videoId
true
String
视频ID【对应api文档的vid字段】
视频播放预览时长,单位:秒
1、请求正确,返回String对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
videoId
true
String
视频ID【对应api文档的vid字段】
thumbnail
false
Integer
是否为视频首图的缩略图,值为1:是;值为0:否。默认为0:非视频首图的缩略图【对应api文档的t字段】
首图地址
1、请求正确,返回VodQueryVideoPasswordResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
videoId
true
String
视频ID【对应api文档的vids字段】
isShowPassword
Boolean
是否显示密码,默认为否
password
String
视频密码
videoId
String
视频id
title
String
视频标题
1、请求正确,返回VodGetVideosPlayTimesResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
videoIds
true
String
多个视频ID(英文逗号分割 状态为半角),建议不超过200个,例如 1b8be3,239c2e【对应api文档的vids字段】
realTime
false
Integer
是否实时,1表示实时,0表示非实时,默认为0:非实时
返回对象是List<VodGetVideosPlayTimesResponse>,VodGetVideosPlayTimesResponse具体元素内容如下:
videoId
String
视频ID【对应api文档的vid字段】
times
Integer
播放次数
1、请求正确,返回VodAccountQueryVideoInfoResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
videoIds
true
String
视频id(可以支持多个,用英文逗号隔开)【对应api文档的vid字段】
返回对象是List<VodAccountQueryVideoInfoResponse>,VodAccountQueryVideoInfoResponse具体元素内容如下:
videoId
String
视频id【对应api文档的vid字段】
basicInfo
BasicInfo
transcodeInfos
Array
metaData
MetaData
snapshotInfo
SnapshotInfo
title
String
视频标题
description
String
视频描述
duration
Integer
源视频时长,单位:秒
coverURL
String
首图地址,大图
creationTime
Date
创建时间,格式:yyyy-MM-dd HH:mm:ss
updateTime
Date
更新时间,格式:yyyy-MM-dd HH:mm:ss
size
Long
源文件大小,单位:Bytes
status
Integer
视频状态码;60/61:已发布;10:等待编码;20:正在编码;50:等待审核;51:审核不通过;-1:已删除;
categoryId
String
分类id, 如1为根目录【对应api文档的cateId字段】
categoryName
String
分类名称【对应api文档的cateName字段】
tags
String
标签
uploader
String
上传者
playUrl
String
播放地址
definition
String
清晰度,SOURCE:原清晰度,LD:普清,SD:标清,HD:高清
duration
Integer
时长,秒
encrypt
Boolean
加密视频为true,非加密为false
format
String
转码格式,如mp4、flv、pdx、hls
fps
Integer
视频帧率
bitrate
Integer
码率kbps
height
Integer
分辨率高,单位:px
width
Integer
分辨率宽,单位:px
status
String
视频状态, normal:可以正常播放,unavailable:不能正常播放
fileSize
Long
编码后视频大小,单位:字节
size
Long
源文件大小,单位:Bytes
format
String
视频容器类型,如mp4、flv等
duration
Integer
源视频时长,单位:秒
bitrate
Integer
视频码率,单位:bps
fps
Integer
视频帧率
height
Integer
分辨率高,单位:px
width
Integer
分辨率宽,单位:px
codec
String
编码格式,如h264、h265等
imageUrl
Array
截图url数组
上传者信息【详见】
1、接口调用有频率限制,,调用常见异常,
1、接口调用有频率限制,,调用常见异常,
视频结果列表【详见】
1、接口调用有频率限制,,调用常见异常,
1、接口调用有频率限制,,调用常见异常,
1、接口调用有频率限制,,调用常见异常,
1、接口调用有频率限制,,调用常见异常,
1、接口调用有频率限制,,调用常见异常,
1、接口调用有频率限制,,调用常见异常,
查询的视频基本信息【详见】
查询的视频转码信息【详见】
查询的视频元数据【详见】
查询的视频截图【详见】