qn

来自于:开发者立即使用

概述

qn 封装了七牛的SDK,能力有限,暂时只有安卓版。出于安全考虑token由服务端生成。

start

上传文件

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

params

file:

  • 类型:字符串
  • 描述:本地文件路径 fs://

key:

  • 类型:字符串
  • 描述:保存的文件名

token:

  • 类型:字符串
  • 描述:从服务端获取的上传token

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
{   
    msg:'上传成功',
    status: true   //布尔型;true||false
    data:  {
        key: 'xxxx.jpg'  //返回的文件名,加上前置域名就是文件完整url
        //data中除key外还有上传生成的一系列详细数据,通常获取key与七牛提供的域名或者自定义的域名拼接即可得到文件完整路径。
    }         
}

-上传进度回调

{
    progress: 0.35   //两位小数 上传完成是是1;

}

err:

  • 类型:JSON对象
  • 内部字段:
{
    msg:"上传失败",
    data:  {}     //失败详情,参照七牛官网文档说明 <a href="https://developer.qiniu.com/kodo/sdk/1236/android">七牛安卓SDK文档</a>
}

示例代码

var qn = api.require('qn');
qn.start({
    file: '文件路径',
    token: 'xxxxx',
    key: 'a.jpg'
}, function(ret, err){
    if(ret){
        if(ret.status){
            alert('上传成功');
        }
        if(ret.progress){
            api.toast({
                msg: "上传进度:"+ret.progress*100,
                duration: 2000,
                location: 'bottom'
            });
        }
    }else{
        alert(JSON.stringify(err));
    }
});

可用性

Android系统

可提供的1.0.0及更高版本