帮助中心 HELP CENTER

Web上传插件(V2.0)

 

说明:
1. 本文档从用户角度简单概述了web上传插件的使用方法。
2. V2.0 版本的使用与 V1.0 版本完全一致,因此无需更改原有的接口调用及逻辑,只要更换 polyv-upload.js 的调用地址即可。
(提示:推荐使用 V2.0 版本;另需确认您当前使用的酷播云套餐版本是否支持API/SDK功能)

一、功能:

  1. 上传文件
    1). 上传前可以进行选择分类、添加标签、选择视频优化处理、修改文件名及文件说明等操作
    2). 可选择默认的上传目录
    3). 可设置是否对源文件进行编码
    4). 支持断点续传。中途断网或浏览器因故障等原因重启后同个文件可以实现从断点续传。(仅在浏览器版本>=IE10及主流浏览器下支持实现该功能)
    5). 同时选择多个文件、上传过程显示进度
  2. 查看视频
    1). 查看视频列表
    2). 根据标题关键字搜索视频
    3). 获取具体的视频信息
    4). 更换封面
    a.上传新图片作为封面
    b.选择视频截图作为封面
    c.选择最近上传的图片作为封面
  3. 可选择只显示“上传列表”或“视频列表”或显示全部
  4. 可调用接口(response、uploadSuccess、uploadFail)返回视频信息
  5. 提供打开、关闭插件的方法

二、浏览器支持

  • 支持大部分主流浏览器,IE浏览器兼容IE9及IE9以上。
  • 在支持HTML5新特性的浏览器中,支持断点续传,最大可上传30GB的文件。
  • 反之,在不支持HTML5新特性的浏览器中(如IE9),不支持断点续传功能,最大可上传2GB的文件。

三、入门教程:

1、首先在调用该插件的页面上添加一个按钮:

<input type="button" id="upload" value="上传"></input> 

2、引入POLYV上传插件的js文件

<script src="//static.polyv.net/file/plug-in-v2/polyv-upload.min.js"></script> 

3、添加脚本,初始化上传参数并新建一个上传实例。

  1. var obj = { 
  2.     uploadButtton: 'upload', 
  3.     userid: data.userid, 
  4.     ts: data.ts, 
  5.     hash: data.hash, 
  6.     sign: data.sign, 
  7.     component: 'all',  
  8.     cataid: 1499657507273,  
  9.     luping: 1, 
  10.     extra: { 
  11.         keepsource: 1, 
  12.     } 
  13. }; 
  14. upload = new PolyvUpload(obj); 

4、定时更新sign等参数
上传参数中的ts、hash、sign有一定的时间期限,需要每隔3分钟更新一次参数
更新参数需要用到update(data)方法。
如果在上传参数中带有正确的requestUrl参数,可由插件内部自动更新sign等值。

5、上传参数解释:

  • uploadButtton:打开上传控件按钮的id
  • userid:可以在“云点播”后台->“设置”->“API接口”页面中找到您的userid
  • ts:13位的毫秒级时间戳
  • hash:是根据将ts和writeToken按照顺序拼凑起来的字符串进行MD5计算得到的值
  • sign:是根据将secretkey和ts按照顺序拼凑起来的字符串进行MD5计算得到的值
  • component(可选):可以设置为videoList(只显示视频列表)、 uploadList(只显示上传列表)、all(默认值,显示上传列表和视频列表)
  • cataid(可选):上传目录id,默认值为1
  • luping(可选):开启视频课件优化处理,对于上传录屏类视频清晰度有所优化。可设置为01,默认值为0,表示不开启课件优化
  • keepsource(可选):源文件播放(不对源文件进行编码)。可设置为0(对源文件进行编码)或1(源文件播放)

6、获取用户信息的代码示例(PHP)

  1. /*  
  2. 说明:以下的userid、secretkey、writeToken、readToken可以在“云点播”后台->“设置”->“API接口”页面中找到。 
  3. */ 
  4. $userid = "your userid"
  5. $secretkey = "your sercrety"
  6. $writeToken = "your writeToken"
  7. $readToken = "your readToken"
  8.  
  9. $ts = time() * 1000; 
  10. $hash = md5($ts . $writeToken); 
  11. $sign = md5($secretkey . $ts); 

 

四、使用文档

1.上传参数options

  • uploadButtton:打开上传控件按钮的id
  • userid
  • ts:13位的毫秒级时间戳
  • hash:是根据将ts和writeToken按照顺序拼凑起来的字符串进行MD5计算得到的值
  • sign:是根据将secretkey和ts按照顺序拼凑起来的字符串进行MD5计算得到的值
  • requestUrl(可选):插件内定时更新sign信息的请求地址(如果填写了该项,则不必传入useridtshashsign这4个参数,也不需要定时更新sign等参数)
  • component(可选):可以设置为videoList(只显示视频列表)、 uploadList(只显示上传列表)、all(默认值,显示上传列表和视频列表)
  • cataid(可选):上传目录id,默认值为1
  • luping(可选):开启视频课件优化处理,对于上传录屏类视频清晰度有所优化。可设置为01,默认值为0,表示不开启课件优化
  • defaultTagPlaceholder(可选):自定义标签输入框占位符
  • defaultDescPlaceholder(可选):自定义视频描述输入框占位符
  • fileLimit(可选):可上传单个视频的大小,默认不限制
  • fileLimitTips(可选):超出大小限制时的提示语
  • fileNumberLimit (可选):最大单次可上传文件数,默认不限制
  • fileNumberLimitTips(可选):超出最大单次可上传文件数限制时的提示语
  • width(可选):弹框的宽,最小900px;默认值1000px
  • height(可选):弹框的高,最小500px;默认值600px
  • extra(可选): object
    可添加的属性为keepsource:源文件播放(不对源文件进行编码)。可设置为0(对源文件进行编码)或1(源文件播放)
    javascript
    {
    keepsource: 1, // 源文件播放(不对源文件进行编码)
    }
  • response(可选): function,返回指定视频的信息时的回调函数
  • uploadSuccess(fileData)(可选):function,当前文件上传完毕时触发的回调函数
  • uploadFail(err)(可选):function,当前文件上传失败时触发的回调函数

2.方法

  • update(data): 用于更新ts、hash、sign3个信息
  • closeWrap(): 关闭插件
  • openWrap(): 打开插件

五、demo下载

demo下载:Web上传插件源码

 


立即注册使用 快速入门