UPYUNFusion 1.0.1

UPYUNFusion 1.0.1

×

测试已测试✓
语言语言 Obj-CObjective C
许可 MIT
发布最后发布2016年2月

由 upyun-ios 维护。

UPYUNFusion 1.0.1

  • 由
  • UPYUN

UPYUN Fusion iOS SDK

UPYUN Fusion iOS SDK 集成

运行环境

  • iOS 7.0 及以上版本，ARC 模式，采用 NSURLSession 做网络库 > 注：因为 iOS 9 的 ATS，如果使用七牛的容灾功能，请将七牛的上传 URL 设置为信任，可以参考stackoverflow

使用说明：

1.直接下载，引入 UPYUNSDK 文件夹，然后 CocoaPods
pod 'AliyunOSSiOS', '~> 2.2.0' ，之后 #import "UpYun.h" 即可使用

2.使用 Cocoapods，pod 'UPYUNFusion', '~> 1.0.0''，之后 #import "UpYun.h" 即可使用

注：该项目依赖 AliyunOSSiOS

参数设置

在 UPYUNConfig.m 中可以对 SDK 的一些参数进行配置，也可以通过 [UPYUNConfig sharedInstance].DEFAULT_BUCKET 来进行修改

  • DEFAULT_BUCKET : 默认空间名（必填项）,
  • DEFAULT_PASSCODE : 默认表单 API 功能密钥 , 用户从服务端获取 signature 则无须填写
  • DEFAULT_EXPIRES_IN : 默认当前上传授权的过期时间，单位为“秒” （必填项，较大文件需要较长时间)
  • DEFAULT_RETRY_TIMES : 失败之后重传次数, 默认2次
  • SingleBlockSize : 单个分块大小, 默认500KB

  • thirdUpload : 在上传 upyun 失败之后，选择七牛还是阿里云进行容灾上传, kQiniuUpload 使用七牛, kAliyunUPload , 使用阿里云

  • QiniuToken : 七牛的上传 token , 详细参考七牛安全机制

  • AliyunBucket : 阿里云的 Bucket
  • AliyunAccessKey : 阿里云的 AccessKey
  • AliyunSecretKey : 阿里云的 SecretKey

注意：如果需要在上传的过程中不断变动一些参数值，建议初始化 UpYun 之后，通过 UpYun 的属性来修改

上传接口

详细示例请见 UpYunFusionSDKDemo 的 Viewcontroller。

文件上传

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.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 字符串，用户可以直接上传到用户服务端与 密钥 拼接
  • 返回的参数：
    • sinature: 用户服务端使用上传的 policy 生成的 sinature，或者用户自己生成 sinature

7、params 可选参数

8、uploadMethod 上传方法选择

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

错误代码

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