qiniuUpfile

upfile

概述

qiniuUpfile插件封装了七牛上传文件的相关操作，开发者只需简单地调用相关接口，即可把图片或文档上传到七牛并共享给其他用户，本插件使用前需到七牛注册账号，本插件采用本地模拟TOKEN生成，不需要另外架设TOKEN服务器。

使用此插件之前需配置 config 文件来设置bucket以及SK、AK，配置方法如下：

  • 名称：qiniuUpfile

  • 参数：bucket，SecretKey，AccessKey

  • 备注：以上参数为必填项，青依据实际情况填写，否则上传时会报错。

  • 配置示例:

    <feature name="qiniuUpfile">
 <param name="bucket" value="空间名"/>
 <param name="SecretKey" value="你在七牛获取到的SecretKey"/>
 <param name="AccessKey" value="你在七牛获取到的AccessKey"/>
</feature>

  • 字段描述:

      1. bucket：在注册七牛后自定义的空间名称
  2. SecretKey:安全秘钥
  3. AccessKey: 授权秘钥

获取AK/SK

登录七牛后在个人控制面板中选择秘钥管理，点击可查看管理AK/SK image

image

自定义bucket

注册登录后添加资源，选择添加对象存储 image 按要求输入自定义的名称 image

获取回调地址

文件上传成功后，需要在程序中引用，七牛提供一个测试的地址供我们使用，每个人分配的地址都是唯一的。

地址获取方法如下：1、选择你新建的【对象存储】

image 2、查看七牛的测试域名 image

3、将测试域名记录，并与返回的KEY组合，即为文件地址，如http://xxx.z0.glb.clouddn.com/xxxxc

upfile

上传文件

upfile({params}, callback(ret, err))

params

file：

  • 类型：字符串
  • 默认值：无
  • 描述：（必选项）通过图片或文件选择器获得的文件路径url

name：

  • 类型：字符串
  • 默认值：无
  • 描述：（非必选项）自定义的在七牛空间中的文件名，如不填写则采用文件的HASH值做文件名，避免文件名有冲突

callback(ret, err)

ret：

  • 类型：JSON对象

内部字段：

   ```js
   {
    status:			//状态值:true; false
    oper:          //操作状态:complete-完成;progress-进度
    info{          //只在oper为complete的时候返回，progress时为隐藏
         key:      //返回的文件名
         hash:     //返回的文件哈希值
    }
    percent:    //上传进度,如1.1,12.11,50.34......95.0......100
    }
   ```

err：

  • 类型：JSON对象

内部字段：

    ```js
   {
   msg:            //错误信息
    }
   ```

示例代码

   ...html
   <div>
        上传进度：<p id="progress"></p>
    </div>
       <p id="backurl"></p>

   ```js
    var a = document.getElementById('progress');//显示进度，也可用进度条，在进度从95%到100%的时候有个明显停顿，此时文件已经传输完成，是在获取回调信息。
    var b = document.getElementById('imge');
    var fileurl = '/storage/emulated/0/UZMap/picture/p1357545.jpg';//文件地址，也可通过文件选择器获得
    var baseUrl = 'xxxx.com0.z0.glb.clouddn.com';//七牛给你的测试域名，也可使用自己捆绑的域名youe.xxx.com
    var obj = api.require('qiniuUpfile');
        obj.upfile({
        file:fileurl,
        name:'hello'
        },function(ret,err){
            if(ret.status) {
              if(ret.oper == "complete"){
             //上传成功后组装访问路径，或直接访问文档
             $api.text(b, baseUrl+ret.info.key);
              }else if(ret.oper == "progress"){
               //上传过程中获取进度数据
                $api.text(a, ret.percent);
              }
             }
        });
    ```

补充说明

【文档管理】

登录七牛后台可进行上传文件的管理 image image 外链默认域名加文件名就是文件的连接。

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2025/09/15