Skip to content

nickcheng/ios-form-sdk

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

又拍云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错误代码表

About

Upyun iOS sdk

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published