qn

来自于：开发者立即使用

start

概述

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

start

上传文件

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

params

file：

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

key：

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

token：

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

callback(ret, err)

ret：

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

-上传进度回调

  1. {
  2.     progress: 0.35   //两位小数 上传完成是是1；
  4. }

err：

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

示例代码

  1. var qn = api.require('qn');
  2. qn.start({
  3.     file: '文件路径',
  4.     token: 'xxxxx',
  5.     key: 'a.jpg'
  6. }, function(ret, err){
  7.     if(ret){
  8.         if(ret.status){
  9.             alert('上传成功');
  10.         }
  11.         if(ret.progress){
  12.             api.toast({
  13.                 msg: "上传进度："+ret.progress*100,
  14.                 duration: 2000,
  15.                 location: 'bottom'
  16.             });
  17.         }
  18.     }else{
  19.         alert(JSON.stringify(err));
  20.     }
  21. });

可用性

Android系统

可提供的1.0.0及更高版本