Java 上传SDK使用文档
Polyv Java 上传 SDK 为您提供服务端上传媒体文件到保利威云点播平台的开发工具包。
功能
快捷上传多种格式的媒体文件。
支持上传时的各种设置,如文件标题、描述、标签、上传目录、是否开启课件优化处理等。
采用分片并发上传的方式,支持断点续传。
使用方法
前提条件
使用本 SDK 前,要先开通保利威云点播服务。如果您还不了解该服务,请登录产品主页查看,详见:云点播。
获取userId、secretKey 等相关信息用于用户身份校验,您可以在「云点播管理后台 -> 设置 -> API接口」页面中找到相关信息,点击这里登录后台。
环境要求
Java版本1.8.0及以上
集成 SDK
下载Java上传SDK开发包(包含示例代码和所需jar包),点击这里下载。
将解压后的jar文件拷贝至您的项目中;
使用IDE开发时引用jar包的方法,以Eclipse和IntelliJ IDEA为例说明如下:
3.1 在Eclipse中选择您的工程,右击 -> Properties -> Java Build Path -> Add JARs;
3.2 在IntelliJ IDEA中打开您的工程,File -> Project Structure -> Modules -> 右侧Dependencies -> + -> JARs or directories
API参考
1. 入口类 PolyvUploadClient.java
1.1 构造方法
参数解释:
userId
保利威账号ID
secretKey
保利威账号的secretKey
partitionSize
可指定分片上传时每个分片的大小,单位:字节,默认为1MB,取值范围为100KB~5GB
checkpoint
使用断点续传时,写入续传位置的本地磁盘路径,需保证文件路径已经创建好
threadNum
可指定分片上传时的并发线程数,默认为1。注:该配置会占用服务器CPU资源,需根据服务器情况指定。
1.2 上传方法
该方法返回视频ID。
2. 视频实体类 VideoInfo.java
视频信息字段:
fileLocation
String
true
视频文件在本地的绝对路径,必须包含文件后缀
title
String
false
视频标题,为空时会取视频文件名作为标题(不含后缀)
fileSize
Long
false
文件大小
describ
String
false
视频简介
tag
String
false
视频标签,多个用英文逗号分隔
cataId
Long
false
视频分类id,默认值:1,表示上传到默认分类
keepsource
Integer
false
是否保持源文件播放,默认:0
videoPoolId
String
false
视频ID,当上传中断续传时,需要指定vid来恢复上传
示例代码
Change log
2020-03-29
v1.1.1
支持自定义拓展字段,可在上传完成回调中透传返回
2019-08-05
v1.0.0
支持断点续传的新版Java上传SDK 发布
Last updated
Was this helpful?