Code Monkey home page Code Monkey logo

ios-form-sdk's Introduction

#这个 SDK 将不再维护, 请使用新版SDK

又拍云iOS SDK

又拍云存储iOS SDK,基于 [又拍云存储 表单 API接口] (http://wiki.upyun.com/index.php?title=%E8%A1%A8%E5%8D%95API%E6%8E%A5%E5%8F%A3) 开发。

使用说明

要求

iOS6.0及以上版本,ARC模式

参数设置

  • DEFAULT_BUCKET : 默认空间名(必填项)
  • DEFAULT_PASSCODE : 默认表单API功能密钥 (必填项)
  • DEFAULT_EXPIRES_IN : 默认当前上传授权的过期时间,单位为“秒” (必填项,较大文件需要较长时间)

初始化UpYun

UpYun *uy = [[UpYun alloc] init];

上传文件

uy.successBlocker = ^(id data){
  //TODO
};
uy.failBlocker = ^(NSError * error){
  //TODO
};
uy.progressBlocker = ^(CGFloat percent,long long requestDidSendBytes){
  //TODO
};
[uy uploadFile:'file' saveKey:'saveKey'];
参数说明:

#####1、file 需要上传的文件

  • 可传入类型:
  • NSData: 文件数据
  • NSString: 本地文件路径
  • UIImage: 传入的图片 (当以此类型传入图片时,都会转成PNG数据,需要其他格式请先转成NSData传入 或者 传入文件路径)

#####2、saveKey 要保存到又拍云存储的具体地址

  • 可传入类型:
  • NSString: 要保存到又拍云存储的具体地址
  • 由开发者自己生成saveKey:
    • 比如/dir/sample.jpg表示以sample.jpg为文件名保存到/dir目录下;
    • 若保存路径为/sample.jpg,则表示保存到根目录下;
    • 注意saveKey的路径必须是以/开始的,下同
  • 由开发者传入关键key由服务器生成saveKey:
    • 比如/{year}/{mon}/{filename}{.suffix}表示以上传文件完成时服务器年({year})、月({mon})最为目录,以传入的文件名({filename})及后缀({.suffix})作为文件名保存
    • 特别的 当参数fileUIImageNSData类型传入时,saveKey不能带有{filename}
    • 其他服务器支持的关键key详见 save-key详细说明

#####3、successBlocker 上传成功回调

  • 回调中的参数:
  • data: 成功后服务器返回的信息

#####4、failBlocker 上传失败回调

  • 回调中的参数:
  • error: 失败后返回的错误信息

#####5、progressBlocker 上传进度度回调

  • 回调中的参数:
  • percent: 上传进度的百分比
  • requestDidSendBytes: 已经发送的数据量

错误代码

  • -1998: 参数fileUIImageNSData类型传入时,saveKey带有{filename}
  • -1999: 参数fileUIImageNSDataNSString外的类型传入
  • 其他错误代码详见 表单API错误代码表

ios-form-sdk's People

Contributors

anddyyao avatar iblacksun avatar linknoweasy avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

ios-form-sdk's Issues

文档链接 404

Hi,由于又拍文档改过了,wiki 里面的链接地址都失效了,能否更新至新文档,thanks !

同时上传多个图片的progress?

可以多次调用uploadImageData:saveKey:方法做到同时上传多个图片,但是无法通过progressBlocker统计具体某个图片的上传进度,也就无法得到整体的上传进度了。能否在progressBlocker添加一个可以标记是哪一张图片的参数,或者是否有我没有发现的其他方法可以做到?谢谢

自动添加根目录

若用户传入的 savekey 没有根目录,比如说“sample.jpg”,则会调用出错。
作为 SDK ,最好直接封装掉这个处理,若发现传入的参数没有带根目录则自动添加,比如:

  • 传入的参数为“sample.jpg”,则自动转换成“/sample.jpg”
  • 传入的参数为“/sample.jpg”,则保持不变,还是“/sample.jpg”

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.