UPYUN iOS SDK

UPYUN iOS SDK, 集成

• 又拍云存储 表单 API接口
• 又拍云存储 分块上传接口

使用说明：

• 1. 直接下载，引入 UPYUNSDK 文件夹，#import "UpYun.h" 即可使用
• 2. 通过 CocoaPods pod 'UPYUN_iOS_SDK', '~> 1.0.0' ，#import "UpYun.h" 即可使用###要求
• iOS 7.0 及以上版本，ARC 模式，采用 NSURLSession 做网络库
• iOS 9+ 强制使用 https，需要在 XXX.plist 添加 NSAppTransportSecurity 类型 Dictionary. 在 NSAppTransportSecurity 下添加 NSAllowsArbitraryLoads 类型 Boolean ,值设为 YES . --详细操作可参考 iOS9 HTTP 不能正常使用的解决办法 和 在Xcode7/7.1中使用Http请求

参数设置

在 UpYun.h 中可以对 SDK 的一些参数进行配置。

• DEFAULT_BUCKET : 默认空间名（必填项）
• DEFAULT_PASSCODE : 默认表单 API 功能密钥 , 用户从服务端获取 signature 则无须填写
• DEFAULT_EXPIRES_IN : 默认当前上传授权的过期时间，单位为“秒” （必填项，较大文件需要较长时间)
• DEFAULT_MUTUPLOAD_SIZE : 默认 fallback 分块上传的大小, 初始值: 2M

初始化 UpYun

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

上传文件

uy.successBlocker = ^(NSURLResponse *response, id responseData) {
  //TODO
};
uy.failBlocker = ^(NSError * error) {
  //TODO
};
uy.progressBlocker = ^(CGFloat percent,long long requestDidSendBytes) {
  //TODO
};
uy.signatureBlocker = ^(NSString *policy) {
  return @"";
};
[uy.params setObject:@"value" forKey:@"key"];
uy.uploadMethod = UPFormUpload;

[uy uploadFile:'file' saveKey:'saveKey'];

参数说明：

1、file 需要上传的文件

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

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

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

3、successBlocker 上传成功回调

• 回调中的参数：
  • response: 成功后服务器返回的信息响应
  • responseData: 成功后服务器返回的数据 body (JSON)格式

4、failBlocker 上传失败回调

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

5、progressBlocker 上传进度回调

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

6、signatureBlocker 用户获取 signature 回调

• 回调中的参数：
  • policy：经过处理的 policy 字符串，用户可以直接上传到用户服务端与 密钥 拼接
• 返回的参数：
  • signature：用户服务端使用上传的 policy 生成的 signature，或者用户自己生成 signature

7、params 可选参数

8、uploadMethod 上传方法选择

• 默认根据文件大小选择表单还是分块上传，可以通过 uy.uploadMethod = UPFormUpload 来选择表单上传，uy.uploadMethod = UPMtUPload 来选择分块上传。

错误代码

• -1997：参数 filepath，找不到文件
• -1998：参数 file 以 UIImage、NSData 类型传入时，saveKey 带有 {filename}
• -1999：参数 file 以 UIImage、NSData、NSString 外的类型传入
• 其他错误代码详见 表单API错误代码表