对象存储

  • JavaScript SDK

    最近更新时间:2017-11-14 16:43:29

    JavaScript SDK 适用于 IE9+、Chrome、Firefox、Safari 等浏览器,基于七牛云 API 构建。开发者使用本 SDK 可以方便的从浏览器端上传文件至七牛云,并对上传成功后的图片进行丰富的数据处理操作。

    本 SDK 为客户端 SDK,没有包含 token 生成实现,为了安全,token 建议您通过网络从服务端获取,具体生成代码可以参考七牛服务端官方 SDKs。

    功能简介

    • 上传
      • html5 模式大于 4 M 时可分块上传,小于 4 M 时直传
      • Flash、html4 模式直接上传
      • 继承了 Plupload 的功能,可筛选文件上传、拖曳上传等
    • 下载(公开资源)
    • 数据处理(图片)
      • imageView2(缩略图)
      • imageMogr2(高级处理,包含缩放、裁剪、旋转等)
      • imageInfo (获取基本信息)
      • exif (获取图片 EXIF 信息)
      • watermark (文字、图片水印)
      • pipeline (管道,可对 imageView2、imageMogr2、watermark 进行链式处理)

    服务端准备

    本 SDK 依赖服务端颁发的上传凭证,可以通过以下二种方式实现:

    • 利用七牛服务端 SDK 构建后端服务
    • 利用七牛底层 API 构建服务,详见七牛上传策略上传凭证

    后端服务应提供一个 URL 地址,供 SDK 初始化使用,前端通过 Ajax 请求该地址后获得 upToken。 Ajax 请求成功后,服务端应返回如下格式的 json:

    {
    "uptoken": "0MLvWPnyya1WtPnXFy9KLyGHyFPNdZceomL..."
    }
    

    引入 Plupload

    本 SDK 上传功能基于Plupload插件封装,所以需要下载Plupload,建议使用 2.1.1 ~ 2.1.9。您也可以访问开放静态文件 CDN ,搜索 plupload ,使用 CDN 加速的静态文件地址。

    引入 qiniu.js

    获取 SDK 源码:

    git clone git@github.com:qiniupd/qiniu-js-sdk.git
    

    qiniu.js 位于 src 目录内

    初始化

    要接入七牛云存储,您需要拥有一对有效的 Access Key 和 Secret Key 进行签名认证。可以通过如下步骤获得:

    1. 开通七牛开发者帐号
    2. 登录七牛开发者平台,查看Access Key 和 Secret Key

    安装

    • 通过 Github 上的 qiniu/js-sdk 仓库获取,下载最新的发布版本并解压或直接克隆仓库,JS-SDK 在 dist 目录中:

        git clone https://github.com/qiniu/js-sdk.git
      
    • 直接使用 CDN 加速的静态文件地址,访问开放静态文件 CDN,搜索 qiniu:

        https://cdn.staticfile.org/qiniu-JS-SDK/<version>/qiniu.min.js
      
    • 使用 Bower 安装,Bower 是一个客户端技术的软件包管理器,它可用于搜索、安装和卸载 (JavaScript、HTML、CSS) 等网络资源。如果需要更详细的关于 Bower 的使用说明,您可以访问Bower 官方网站。通过 Bower 安装会将 JS-SDK 依赖的 plupload 也一起安装在 bower_components 中:

        bower install qiniu
      

      执行之后,JS-SDK 和 plupload 分别在以下位置:

        bower_components
        ├── plupload
        │   └── js
        │       ├── moxie.js
        │       ├── moxie.min.js
        │       ├── plupload.dev.js
        │       ├── plupload.full.min.js
        │       └── plupload.min.js
        └── qiniu
            └── dist
                ├── qiniu.js
                ├── qiniu.min.js
                └── qiniu.min.map
      
    • 使用 NPM 安装,NPM 的全称是 Node Package Manager,是一个NodeJS包管理和分发工具,已经成为了非官方的发布 Node 模块(包)的标准。如果需要更详细的关于 NPM 的使用说明,您可以访问NPM 官方网站,或对应的中文网站

        npm install qiniu-js
      

      执行之后,JS-SDK 在以下位置:

        node_modules
        └── qiniu-js
            └── dist
                ├── qiniu.js
                ├── qiniu.min.js
                └── qiniu.min.map
      

    上传

    • 在页面中引入 plupload,plupload.full.min.js(产品环境)或引入 plupload.dev.js 和 moxie.js(开发调试)

    • 在页面中引入 qiniu.min.js(生产环境)或 qiniu.js(开发调试)

    • 初始化 uploader (请确保在执行初始化时,页面已经引入 plupload):

        var uploader = Qiniu.uploader({
            runtimes: 'html5,flash,html4',      // 上传模式,依次退化
            browse_button: 'pickfiles',         // 上传选择的点选按钮,必需
            // 在初始化时,uptoken,uptoken_url,uptoken_func三个参数中必须有一个被设置
            // 切如果提供了多个,其优先级为uptoken > uptoken_url > uptoken_func
            // 其中uptoken是直接提供上传凭证,uptoken_url是提供了获取上传凭证的地址,如果需要定制获取uptoken的过程则可以设置uptoken_func
            // uptoken : '<Your upload token>', // uptoken是上传凭证,由其他程序生成
            // uptoken_url: '/uptoken',         // Ajax请求uptoken的Url,强烈建议设置(服务端提供)
            // uptoken_func: function(){    // 在需要获取uptoken时,该方法会被调用
            //    // do something
            //    return uptoken;
            // },
            get_new_uptoken: false,             // 设置上传文件的时候是否每次都重新获取新的uptoken
            // downtoken_url: '/downtoken',
            // Ajax请求downToken的Url,私有空间时使用,JS-SDK将向该地址POST文件的key和domain,服务端返回的JSON必须包含url字段,url值为该文件的下载地址
            // unique_names: true,              // 默认false,key为文件名。若开启该选项,JS-SDK会为每个文件自动生成key(文件名)
            // save_key: true,                  // 默认false。若在服务端生成uptoken的上传策略中指定了sava_key,则开启,SDK在前端将不对key进行任何处理
            domain: '<Your bucket domain>',     // bucket域名,下载资源时用到,必需
            container: 'container',             // 上传区域DOM ID,默认是browser_button的父元素
            max_file_size: '100mb',             // 最大文件体积限制
            flash_swf_url: 'path/of/plupload/Moxie.swf',  //引入flash,相对路径
            max_retries: 3,                     // 上传失败最大重试次数
            dragdrop: true,                     // 开启可拖曳上传
            drop_element: 'container',          // 拖曳上传区域元素的ID,拖曳文件或文件夹后可触发上传
            chunk_size: '4mb',                  // 分块上传时,每块的体积
            auto_start: true,                   // 选择文件后自动上传,若关闭需要自己绑定事件触发上传
            //x_vars : {
            //    查看自定义变量
            //    'time' : function(up,file) {
            //        var time = (new Date()).getTime();
                      // do something with 'time'
            //        return time;
            //    },
            //    'size' : function(up,file) {
            //        var size = file.size;
                      // do something with 'size'
            //        return size;
            //    }
            //},
            init: {
                'FilesAdded': function(up, files) {
                    plupload.each(files, function(file) {
                        // 文件添加进队列后,处理相关的事情
                    });
                },
                'BeforeUpload': function(up, file) {
                       // 每个文件上传前,处理相关的事情
                },
                'UploadProgress': function(up, file) {
                       // 每个文件上传时,处理相关的事情
                },
                'FileUploaded': function(up, file, info) {
                       // 每个文件上传成功后,处理相关的事情
                       // 其中info.response是文件上传成功后,服务端返回的json,形式如:
                       // {
                       //    "hash": "Fh8xVqod2MQ1mocfI4S4KpRL6D98",
                       //    "key": "gogopher.jpg"
                       //  }
                       // 查看简单反馈
                       // var domain = up.getOption('domain');
                       // var res = parseJSON(info.response);
                       // var sourceLink = domain +"/"+ res.key; 获取上传成功后的文件的Url
                },
                'Error': function(up, err, errTip) {
                       //上传出错时,处理相关的事情
                },
                'UploadComplete': function() {
                       //队列文件处理完毕后,处理相关的事情
                },
                'Key': function(up, file) {
                    // 若想在前端对每个文件的key进行个性化处理,可以配置该函数
                    // 该配置必须要在unique_names: false,save_key: false时才生效
      
                    var key = "";
                    // do something with key here
                    return key
                }
            }
        });
      
        // domain为七牛空间对应的域名,选择某个空间后,可通过 空间设置->基本设置->域名设置 查看获取
      
        // uploader为一个plupload对象,继承了所有plupload的方法
      
    • 如果一个页面中有多个上传实例,可以按如下操作:

        var option1 = {
            key : val ,
            ……
        };
        var uploader = Qiniu.uploader(option1);
      
        var Qiniu2 = new QiniuJsSDK();
        var option2 = {
            key : val ,
            ……
        };
        var uploader2 = Qiniu2.uploader(option2);
      

    数据处理

    对上传成功的图片进行数据处理:

    watermark(水印)

    // key为每个文件上传成功后,服务端返回的json字段,即资源的最终名字,下同
    // key可在每个文件FileUploaded事件被触发时获得
    var imgLink = Qiniu.watermark({
             mode: 1,  // 图片水印
             image: 'http://77flds.com2.z0.glb.qiniucdn.com/images/logo-2.png', // 图片水印的Url,mode = 1时,必需
             dissolve: 50,          // 透明度,取值范围1-100,非必需,下同
             gravity: 'SouthWest',  // 水印位置,为以下参数[NorthWest、North、NorthEast、West、Center、East、SouthWest、South、SouthEast]之一
             dx: 100,  // 横轴边距,单位:像素(px)
             dy: 100   // 纵轴边距,单位:像素(px)
         }, key);      // key为非必需参数,下同
    // imgLink可以赋值给html img元素的src属性,下同
    // 若未指定key,可以通过以下方式获得完整的imgLink,下同
    // imgLink  =  '<domain>/<key>?' +  imgLink
    // <domain> 为七牛空间(bucket)对应的域名,选择某个空间后,可通过 空间设置->基本设置->域名设置 查看获取
    

    var imgLink = Qiniu.watermark({
             mode: 2,  // 文字水印
             text: 'hello world !', // 水印文字,mode = 2时,必需
             dissolve: 50,          // 透明度,取值范围1-100,非必需,下同
             gravity: 'SouthWest',  // 水印位置,同上
             fontsize: 500,         // 字体大小,单位:缇
             font : '黑体',          // 水印文字字体
             dx: 100,  // 横轴边距,单位:像素(px)
             dy: 100,  // 纵轴边距,单位:像素(px)
             fill: '##FFF000'        // 水印文字颜色,RGB格式,可以是颜色名称
    }, key);
    

    具体水印参数解释请参阅图片水印处理 (watermark)

    imageView2

    var imgLink = Qiniu.imageView2({
           mode: 3,  // 缩略模式,共6种[0-5]
           w: 100,   // 具体含义由缩略模式决定
           h: 100,   // 具体含义由缩略模式决定
           q: 100,   // 新图的图像质量,取值范围:1-100
           format: 'png'  // 新图的输出格式,取值范围:jpg,gif,png,webp等
    }, key);
    

    具体缩略参数请参阅图片基本处理 (imageView2)

    imageMogr2

    var imgLink = Qiniu.imageMogr2({
           auto-orient: true,  // 布尔值,是否根据原图EXIF信息自动旋正,便于后续处理,建议放在首位。
           strip: true,   // 布尔值,是否去除图片中的元信息
           thumbnail: '1000x1000'   // 缩放操作参数
           crop: '!300x400a10a10',  // 裁剪操作参数
           gravity: 'NorthWest',    // 裁剪锚点参数
           quality: 40,  // 图片质量,取值范围1-100
           rotate: 20,   // 旋转角度,取值范围1-360,缺省为不旋转。
           format: 'png',// 新图的输出格式,取值范围:jpg,gif,png,webp等
           blur:'3x5'    // 高斯模糊参数
    }, key);
    

    具体高级图像处理参数请参阅图片高级处理 (imageMogr2)

    imageInfo

    var imageInfoObj = Qiniu.imageInfo(key);
    

    具体 imageInfo 解释请参阅图片基本信息 (imageInfo)

    说明:Ajax 跨域限制,IE 系列只支持 IE10+。

    exif

    var exifOjb = Qiniu.exif(key);
    

    具体 exif 解释请参阅图片EXIF信息 (exif)

    说明:Ajax 跨域限制,IE 系列只支持 IE10+。

    pipeline(管道操作)

    var fopArr = [{
            fop: 'watermark', // 指定watermark操作
            mode: 2, // 此参数同watermark函数的参数,下同。
            text: 'hello world !',
            dissolve: 50,
            gravity: 'SouthWest',
            fontsize: 500,
            font : '黑体',
            dx: 100,
            dy: 100,
            fill: '##FFF000'
    },{
            fop: 'imageView2',  // 指定imageView2操作
            mode: 3,  // 此参数同imageView2函数的参数,下同
            w: 100,
            h: 100,
            q: 100,
            format: 'png'
    },{
            fop: 'imageMogr2',  // 指定imageMogr2操作
            auto-orient: true,  // 此参数同imageMogr2函数的参数,下同。
            strip: true,
            thumbnail: '1000x1000'
            crop: '!300x400a10a10',
            gravity: 'NorthWest',
            quality: 40,
            rotate: 20,
            format: 'png',
            blur:'3x5'
    }];
    // fopArr可以为三种类型watermark、imageMogr2、imageView2中的任意1-3个
    // 例如只对watermark、imageMogr2进行管道操作,则如下即可
    // var fopArr = [{
    //    fop: 'watermark', // 指定watermark操作
    //    mode: 2, // 此参数同watermark函数的参数,下同。
    //    text: 'hello world !',
    //    dissolve: 50,
    //     gravity: 'SouthWest',
    //     fontsize: 500,
    //     font : '黑体',
    //     dx: 100,
    //     dy: 100,
    //     fill: '##FFF000'
    // },{
    //    fop: 'imageMogr2',  // 指定imageMogr2操作
    //    auto-orient: true,  // 此参数同imageMogr2函数的参数,下同。
    //    strip: true,
    //    thumbnail: '1000x1000'
    //    crop: '!300x400a10a10',
    //    gravity: 'NorthWest',
    //    quality: 40,
    //    rotate: 20,
    //    format: 'png',
    //    blur:'3x5'
    // }];
    var imgLink = Qiniu.pipeline(fopArr, key));
    

    具体管道操作解释请参阅管道操作

    运行示例

    直接运行本 SDK 示例网站的服务

    • 安装Nodejs

    • 获取源代码:

       git clone git@github.com:qiniu/js-sdk.git
      
    • 进入项目根目录,执行 make install,安装七牛 Node.js SDK、Express

    • 进入 demo 目录,按照目录下的 config.example 示例,创建 config.js 文件,其中 Access Key 和 Secret Key 按如下方式获取:

      1. 开通七牛开发者帐号
      2. 登录七牛开发者自助平台,查看Access Key 和 Secret Key
    
        module.exports = {
            'ACCESS_KEY': '<Your Access Key>',
            'SECRET_KEY': '<Your Secret Key>',
            'Bucket_Name': '<Your Bucket Name>',
            'Port': 19110,
            'Uptoken_Url': '<Your Uptoken_Url>',
            'Domain': '<Your Bucket Domain>'
        }
    
    • 进入项目根目录,执行 make dev 访问 http://127.0.0.1:19110/http://localhost:19110/

    说明

    • 本 SDK 依赖 Plupload,初始化之前请引入 Plupload。

    • 本 SDK 依赖 uptoken,可以直接设置 upload,通过提供 Ajax 请求地址 uptoken_url 或者通过提供一个能够返回 uptoken 的函数 uptoken_func 实现。

    • 如果您想了解更多七牛的上传策略,建议您仔细阅读上传策略。另外,七牛的上传策略是在后端服务指定的,本 SDK 的 setOption API 只是设置 Plupload 的初始化参数,和上传策略无关。

    • 如果您想了解更多七牛的图片处理,建议您仔细阅读七牛官方文档图片处理

    • 本 SDK 示例生成 upToken 时,指定的 Bucket Name 为公开空间,所以可以公开访问上传成功后的资源。若您生成 upToken 时,指定的 Bucket Name 为私有空间,那您还需要在服务端进行额外的处理才能访问您上传的资源,具体请参阅下载凭证。本 SDK 数据处理功能不适用于私有空间。

    API 参考

    常见问题

    七牛提供基于 plupload 插件封装上传的demo,如果不需要 plupload 插件请参阅https://github.com/iwillwen/qiniu.js/tree/develop,这里主要针对基于 plupload 插件的方式讲解遇到的一些问题,通过参阅 plupload 文档资料,可以对七牛的 demo 进行修改,以满足自己的业务需求,plupload 插件的使用文档请参阅http://www.cnblogs.com/2050/p/3913184.html

    1. 关于上传文件命名问题

    在 main.js 里面,unique_names 是 plupload 插件下面的一个参数,当值为 true 时会为每个上传的文件生成一个唯一的文件名,这个是 plupload 插件自动生成的,如果设置成 false,七牛会以上传的原始名进行命名。

    • 上传的 scope 为 bucket 的形式,unique_names 参数设置为 false ,上传后文件的 key 是本地的文件名 abc.txt。
    • 上传的 scope 为 bucket 的形式,unique_names 参数设置为 true ,plupload 插件会忽略本地文件名,而且这个命名也是没有规律的,上传后文件的 key 是 plupload 插件生成的,如: Yc7DZRS1m73o.txt。
    • 上传的 scope 为 bucket:key 的形式,上传文件本地的名字需要和 scope 中的 key 是一致的,不然会报错key doesn‘t match with scope
      注意:这种形式不能设置 unique_names 为 true,因为即使上传文件本地名字为 abc.txt,但是 plupload 会给这个文件赋值另外一个文件名。
    • 上传的 scope 为 bucket,但是 token 中有设定 saveKey,这种形式 save_key 应该设置为 true ,并且上传的本地文件名需要和这个 savekey 文件名一致。
    • 通过 JS 前端设置上传的 key,在 main.js 文件里面设置如下:
    'Key': function(up, file) {
        var key = "";
        // do something with key
        return key
    }
    

    这个默认是注释的,若想在前端对每个文件的 key 进行个性化处理,可以配置该函数, 该配置必须要在 unique_names: false,save_key: false 时才生效, 取消注释后,其优先级要高于:qiniu.js 文件中 getFileKey。

    2. 设置自定义预览样式

    // 该设置在ui.js文件里,默认为
    var imageView ='?imageView2/1/w/100/h/100'
    // 可修改成
    var imageView ='样式符+样式名'
    

    3. 关于设置取消上传问题

    http://stackoverflow.com/questions/11014384/cancel-file-upload-listener

    (文件 plupload.dev.js 1950行 removeFile : function(file) 方法)

    4. 限制上传文件的类型

    这里分为两种方法:

    1.通过在 token 中设定 mimeLimit 字段限定上传文件的类型,示例:

    • image/*:表示只允许上传图片类型
    • image/jpeg;image/png:表示只允许上传 jpg 和 png 类型的图片
    • !application/json;text/plain:表示禁止上传 json 文本和纯文本(注意最前面的感叹号)

    2.通过 plupload 中设定 filter 参数直接在 JS 前端限定,如下:

    // 可以使用该参数来限制上传文件的类型,大小等,该参数以对象的形式传入,它包括三个属性:
    filters : {
        max_file_size : '100mb',
        prevent_duplicates: true,
        // Specify what files to browse for
        mime_types: [
            {title : "flv files", extensions : "flv"} // 限定flv后缀上传格式上传
            {title : "Video files", extensions : "flv,mpg,mpeg,avi,wmv,mov,asf,rm,rmvb,mkv,m4v,mp4"}, // 限定flv,mpg,mpeg,avi,wmv,mov,asf,rm,rmvb,mkv,m4v,mp4后缀格式上传
            {title : "Image files", extensions : "jpg,gif,png"}, // 限定jpg,gif,png后缀上传
            {title : "Zip files", extensions : "zip"} // 限定zip后缀上传
        ]
    },
    

    5. 设置每次只能选择一个文件

    通过 plupload 插件中的 multi_selection 参数控制,如下:

    // 设置一次只能选择一个文件
    multi_selection: false,
    

    6. 设置取消上传,暂停上传

    在 index.html 中加入两个控制按钮:

    <a class="btn btn-default btn-lg " id="up_load"  href="#" >
         <span>确认上传</span>
    </a>
    <a class="btn btn-default btn-lg " id="stop_load"  href="#" >
         <span>暂停上传</span>
    </a>
    

    然后在 main.js 文件里面绑定这两个按钮,添加代码如下:

    $('#up_load').on('click', function(){
       uploader.start();
    });
    $('#stop_load').on('click', function(){
       uploader.stop();
    });
    

    7. 取消分片上传

    将 main.js 里面的 chunk_size: '4mb' 参数设置为 chunk_size: '0mb',注意分片上传默认分片大小是 4M,如果设置一个别的分片大小则会上传失败。

    8. 取消自动上传

    将 main.js 里面的 auto_start 参数设置为 auto_start: false

    9. 关于请求 token 出现跨域

    因为都是建议用户从后端 SDK 获取 token,然后在 main.js 里设置参数 uptoken_url:'获取uptoken的url',这里就有可能出现跨域的现象,此时在服务端添加 response.setHeader("Access-Control-Allow-Origin","*"); 相应头字段即可。

    推荐一个关于CORS的网站

    10. Android 自带的 Webview 对JS SDK不支持

    在 Android 自带的 Webview 里面引用 JS SDK 的demo

    public class MainActivity extends Activity {
        private WebView webview;
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
            webview = (WebView) findViewById(R.id.wv);
            webview.getSettings().setJavaScriptEnabled(true);
            webview.setWebViewClient(new WebViewClient(){
                public boolean shouldOverrideUrlLoading(WebView view, String url){
                    view.loadUrl(url); 
                    return true;
                }
            });
            webview.loadUrl("http://demos.qiniu.com/demo/simpleuploader/");
        }
    
    }
    

    但是点击选择文件按钮没有反应,这个是 Webview 对 JS 不是很支持造成的,解决方法可以引入这个 Webview ,jar包地址如下: https://o8qpi53g2.qnssl.com/Android-AdvancedWebView.jar,使用方法请参考:

    private AdvancedWebView mWebView;
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
    
            mWebView = (AdvancedWebView) findViewById(R.id.webview);
            mWebView.setListener(this, this);
            mWebView.loadUrl("http://jssdk.demo.qiniu.io/");
        }
    

    11. 关于多个按钮选择文件的 Demo

    很多用户都在问 JSSDK 多文件选择的 Demo,其实只需要在 main.js 文件里多 new 几个 Uploader 对象,然后在主页上写好对应的上传按钮就可以了。

    main.js 里面多 new 几个 uploader 对象:

    $(function() {
        var uploader = Qiniu.uploader({
            runtimes: 'html5,flash,html4',
            browse_button: 'pickfiles',
            container: 'container',
            drop_element: 'container',
            max_file_size: '100mb',
            flash_swf_url: 'js/plupload/Moxie.swf',
            dragdrop: true,
            chunk_size: '4mb',
            uptoken:'um6IEH7mtwnwkGpjImD08JdxlvViuELhI4mFfoeL:79ApUIePTtKIdVGDHJ9D9BfBnhE=:eyJzY29wZSI6ImphdmFkZW1vIiwiZGVhZGxpbmUiOjE0NTk4ODMyMzV9Cg==',
            // uptoken_url: $('#uptoken_url').val(),  //当然建议这种通过url的方式获取token
            domain: $('#domain').val(),
            auto_start: false,
            init: {
                'FilesAdded': function(up, files) {
                    $('table').show();
                    $('#success').hide();
                    plupload.each(files, function(file) {
                        var progress = new FileProgress(file, 'fsUploadProgress');
                        progress.setStatus("等待...");
                    });
                },
                'BeforeUpload': function(up, file) {
                    var progress = new FileProgress(file, 'fsUploadProgress');
                    var chunk_size = plupload.parseSize(this.getOption('chunk_size'));
                    if (up.runtime === 'html5' && chunk_size) {
                        progress.setChunkProgess(chunk_size);
                    }
                },
                'UploadProgress': function(up, file) {
                    var progress = new FileProgress(file, 'fsUploadProgress');
                    var chunk_size = plupload.parseSize(this.getOption('chunk_size'));
    
                    progress.setProgress(file.percent + "%", file.speed, chunk_size);
                },
                'UploadComplete': function() {
                    $('#success').show();
                },
                'FileUploaded': function(up, file, info) {
                    var progress = new FileProgress(file, 'fsUploadProgress');
                    progress.setComplete(up, info);
                },
                'Error': function(up, err, errTip) {
                    $('table').show();
                    var progress = new FileProgress(err.file, 'fsUploadProgress');
                    progress.setError();
                    progress.setStatus(errTip);
                }
            }
        });
    
        uploader.bind('FileUploaded', function() {
            console.log('hello man,a file is uploaded');
        });
    
        $('#up_load').on('click', function(){
            uploader.start();
        });
        $('#stop_load').on('click', function(){
            uploader.stop();
        });
    
        var Q2 = new QiniuJsSDK();
        var uploader2 = Q2.uploader({
            runtimes: 'html5,flash,html4',
            browse_button: 'pickfiles2',
            container: 'container2',
            drop_element: 'container2',
            max_file_size: '100mb',
            flash_swf_url: 'js/plupload/Moxie.swf',
            dragdrop: true,
            chunk_size: '4mb',
            uptoken:'um6IEH7mtwnwkGpjImD08JdxlvViuELhI4mFfoeL:79ApUIePTtKIdVGDHJ9D9BfBnhE=:eyJzY29wZSI6ImphdmFkZW1vIiwiZGVhZGxpbmUiOjE0NTk4ODMyMzV9Cg==',
            // uptoken_url: $('#uptoken_url').val(),  //当然建议这种通过url的方式获取token
            domain: $('#domain').val(),
            auto_start: false,
            init: {
                'FilesAdded': function(up, files) {
                    $('table').show();
                    $('#success').hide();
                    plupload.each(files, function(file) {
                        var progress = new FileProgress(file, 'fsUploadProgress');
                        progress.setStatus("等待...");
                    });
                },
                'BeforeUpload': function(up, file) {
                    var progress = new FileProgress(file, 'fsUploadProgress');
                    var chunk_size = plupload.parseSize(this.getOption('chunk_size'));
                    if (up.runtime === 'html5' && chunk_size) {
                        progress.setChunkProgess(chunk_size);
                    }
                },
                'UploadProgress': function(up, file) {
                    var progress = new FileProgress(file, 'fsUploadProgress');
                    var chunk_size = plupload.parseSize(this.getOption('chunk_size'));
    
                    progress.setProgress(file.percent + "%", file.speed, chunk_size);
                },
                'UploadComplete': function() {
                    $('#success').show();
                },
                'FileUploaded': function(up, file, info) {
                    var progress = new FileProgress(file, 'fsUploadProgress');
                    progress.setComplete(up, info);
                },
                'Error': function(up, err, errTip) {
                    $('table').show();
                    var progress = new FileProgress(err.file, 'fsUploadProgress');
                    progress.setError();
                    progress.setStatus(errTip);
                }
            }
        });
    
        uploader2.bind('FileUploaded', function() {
            console.log('hello man 2,a file is uploaded');
        });
        $('#up_load2').on('click', function(){
            uploader2.start();
        });
        $('#stop_load2').on('click', function(){
            uploader2.stop();
        });
    

    相应的 index.html 文件加入相关按钮:

    <div id="container">
            <a class="btn btn-default btn-lg " id="pickfiles" style="width:160px" href="#" >
                <i class="glyphicon glyphicon-plus"></i>
                <span>选择文件</span>
            </a>
    
            <a class="btn btn-default btn-lg " id="up_load" style="width:160px" href="#" >
                <span>确认上传</span>
            </a>  
    
            <a class="btn btn-default btn-lg " id="stop_load" style="width:160px" href="#" >
                <span>暂停上传</span>
            </a> 
        </div>
    
    <div id="container2">
            <a class="btn btn-default btn-lg " id="pickfiles2" style="width:160px" href="#" >
                <i class="glyphicon glyphicon-plus"></i>
                <span>选择文件</span>
            </a>
    
            <a class="btn btn-default btn-lg " id="up_load2" style="width:160px" href="#" >
                <span>确认上传</span>
            </a>  
    
            <a class="btn btn-default btn-lg " id="stop_load2" style="width:160px" href="#" >
                <span>暂停上传</span>
            </a> 
        </div>
    </div>
    

    相关资源

    如果您有任何关于我们文档或产品的建议和想法,欢迎您通过以下方式与我们互动讨论:

    • 技术论坛 - 在这里您可以和其他开发者愉快的讨论如何更好的使用七牛云服务
    • 提交工单 - 如果您的问题不适合在论坛讨论或希望及时解决,您也可以提交一个工单,我们的技术支持人员会第一时间回复您
    • 博客 - 这里会持续更新发布市场活动和技术分享文章
    • 微博
    • 常见问题

    贡献代码

    1. Fork

    2. 创建您的特性分支 git checkout -b my-new-feature

    3. 提交您的改动 git commit -am 'Added some feature'

    4. 将您的修改记录提交到远程 git 仓库 git push origin my-new-feature

    5. 然后到 github 网站的该 git 远程仓库的 my-new-feature 分支下发起 Pull Request

    许可证

    Copyright (c) 2014 qiniu.com

    基于 MIT 协议发布:

    以上内容是否对您有帮助?
  • 提交工单