前言
项目中有个类似朋友圈的功能,需要支持gif图片的上传与展示,经过大概一天的摸索,也算有点成果,这里整理一下,希望可以给那些有需要的朋友一丢丢帮助。
另外说明下,我项目中用的是PhotoKit(iOS8.0之后推出的),如果你用的是ALAssetsLibrary,可能有些方法就不是很适用了,但是整体的思路应该是通用的。
一个误区
在开始之前,先说一个可能大家都会有的误区(如果你已经知道请无视)
当我们从浏览器里保存了一个gif图片到系统相册里后,我们在系统相册里看到的其实是一个静态的图片,这是因为iOS的系统相册是不支持gif图片预览的。但是这并不表示这个图片就不是gif图片了,实际上它还是gif图片,只是没法通过系统的“照片”这个APP预览出效果而已。
获取gif图片的核心思想
在明白上面那个“误区”后,我们应该就能知道,要想获得gif图片,核心点在于获取图片的原始数据,而不是任何经过压缩或者其他方式处理的图片文件。
在实际的开发过程中,遇到图片选择这种功能,我们一般都会使用一些第三方的开源库,有些开源库里自带了选择“源图片”的功能,有的则没有。比如我在项目中使用的QBImagePicker就没有选择“源图片”的功能,它返回的是一个PHAsset对象的数组,这里就需要我们利用PHAsset去获取源数据。
这里需要注意一点,我们要获取的是NSData数据,而不是UIImage对象,因为据我测试,如果返回的是UIImage对象,那只能获取到gif图片的第一针
由于项目中选择图片后需要对图片尺寸进行压缩(不然实在是太大了,相机拍照的照片源文件大概有2~3M),然后再上传到服务器,所以之前都是利用下面这个方法直接获得压缩后的图片(很高效,内存占用率比获取源图片后再压缩会少很多,之前为了解决多个图片上传时内存爆涨以至于收到内存警告,特意替换了图片选择这块的底层,改使用PhotoKit)
+ (NSMutableArray *)selectedAlbumPhotosWithAlbum:(NSArray *)assets{
NSMutableArray *imageArray = [NSMutableArray array];
CGSize targetSize = CGSizeMake(Max_Image_Width, Max_Image_Height);
PHImageRequestOptions *options = [PHImageRequestOptions new];
options.resizeMode = PHImageRequestOptionsResizeModeFast;
options.synchronous = YES;
PHCachingImageManager *imageManager = [[PHCachingImageManager alloc] init];
for (PHAsset *asset in assets) {
// Do something with the asset
[imageManager requestImageForAsset:asset
targetSize:targetSize
contentMode:PHImageContentModeAspectFill
options:options
resultHandler:^(UIImage *result, NSDictionary *info) {
// 得到一张 UIImage,展示到界面上
NSNumber *isDegraded = info[PHImageResultIsDegradedKey];
if (!isDegraded.boolValue) {
result = [self fixImageOrientation:result];
ImageListModel *model = [ImageListModel modelWithUIImage:result];
[imageArray addObject:model];
}
}];
}
return imageArray;
}
但是这个方法返回的是UIImage对象,而且还是经过压缩后的图片,gif图片经过这么一折腾肯定就不是我们想要的那个了。因此当选择的图片不是gif图片时,我们可以用这个方法。于是下一个问题就归结到如何判断一个PHAsset对象是不是gif图片了。
如何判断PHAsset对象是不是gif图片
这里我也找到很多方法,但是有一些方法会存在使用私有API的风险
- 利用未公开属性filename判断是否包含gif
[asset valueForKey:@"filename"]
- 利用PHImageFileUTIKey判断UTI类型(iOS系统相册是根据 UTI 来区分资源类型的。UTI字面意思是:Uniform Type Identifiers,统一类型标示符)
但是PHImageFileUTIKey也是未公开的
[imageManager requestImageForAsset:asset
targetSize:targetSize
contentMode:PHImageContentModeAspectFill
options:options
resultHandler:^(UIImage *result, NSDictionary *info) {
if ([info[@"PHImageFileUTIKey"] isEqualToString:(__bridge NSString *)kUTTypeGIF]) {
//gif
}
}];
- 利用PHAssetResource,但是PHAssetResource是iOS9.0以后才可用
NSArray *resources = [PHAssetResource assetResourcesForAsset:asset];
NSString *orgFilename = ((PHAssetResource*)resources[0]).originalFilename;
出于对私有API的忌惮(怕被拒啊T.T),我没有采用上面的方法,最后我使用了下面这种方法(至少都是用的公开的API):
还是利用UTI,只不过这个方法是公开的API(其中kUTTypeGIF定义在
[imageManager requestImageDataForAsset:asset
options:options
resultHandler:^(NSData * _Nullable imageData, NSString * _Nullable dataUTI, UIImageOrientation orientation, NSDictionary * _Nullable info) {
DDLogDebug(@"dataUTI:%@",dataUTI);
//gif 图片
if ([dataUTI isEqualToString:(__bridge NSString *)kUTTypeGIF]) {
//这里获取gif图片的NSData数据
}
else {
//其他格式的图片
}
}];
获取gif图片数据
判断出是gif图片后,我们就可以直接拿到NSData数据了,为了跟其他图片区分出,我创建了一个model来保存
(下面这段代码就是对应上面代码里获取gif图片数据的)
//gif 图片
if ([dataUTI isEqualToString:(__bridge NSString *)kUTTypeGIF]) {
BOOL downloadFinined = (![[info objectForKey:PHImageCancelledKey] boolValue] && ![info objectForKey:PHImageErrorKey]);
if (downloadFinined && imageData) {
ImageListModel *model = [[ImageListModel alloc] init];
model.imageData = imageData;
model.image = [UIImage imageWithData:imageData];
model.isGif = YES;
[imageArray addObject:model];
}
}
兼容非gif图片选择
gif图片我们已经可以正确拿到NSData了,对于非gif图片我们也是要兼容的。我们知道在判断是不是gif图片那个方法里已经得到了图片的NSData数据,因此我们可以利用NSData来获得UIImage对象,然后再压缩到目标尺寸:
UIImage *image = [UIImage imageWithData:imageData];
image = [UIImage imageCompressForSize:image targetSize:targetSize];
ImageListModel *model = [ImageListModel modelWithUIImage:image];
[imageArray addObject:model];
但是这个方法有个致命的问题,就是内存问题!因为用了原图的NSData来实例化了UIImage对象,会造成内存猛增,所以我不推荐这种方法。
我的处理方法是再请求一遍压缩图,于是,完整的处理方法是:
/**
* 选择相册图片(包括gif图片)
*
* @param assets PHAsset对象数组
*/
+ (NSMutableArray *)selectedAlbumPhotosIncludingGifWithPHAssets:(NSArray*)assets {
NSMutableArray *imageArray = [NSMutableArray array];
CGSize targetSize = CGSizeMake(Max_Image_Width, Max_Image_Height);
PHImageRequestOptions *options = [PHImageRequestOptions new];
options.resizeMode = PHImageRequestOptionsResizeModeFast;
options.synchronous = YES;
PHCachingImageManager *imageManager = [[PHCachingImageManager alloc] init];
for (PHAsset *asset in assets) {
[imageManager requestImageDataForAsset:asset
options:options
resultHandler:^(NSData * _Nullable imageData, NSString * _Nullable dataUTI, UIImageOrientation orientation, NSDictionary * _Nullable info) {
DDLogDebug(@"dataUTI:%@",dataUTI);
//gif 图片
if ([dataUTI isEqualToString:(__bridge NSString *)kUTTypeGIF]) {
BOOL downloadFinined = (![[info objectForKey:PHImageCancelledKey] boolValue] && ![info objectForKey:PHImageErrorKey]);
if (downloadFinined && imageData) {
ImageListModel *model = [[ImageListModel alloc] init];
model.imageData = imageData;
model.image = [UIImage imageWithData:imageData];
model.isGif = YES;
[imageArray addObject:model];
}
}
else {
//其他格式的图片,直接请求压缩后的图片
[imageManager requestImageForAsset:asset
targetSize:targetSize
contentMode:PHImageContentModeAspectFill
options:options
resultHandler:^(UIImage *result, NSDictionary *info) {
// 得到一张 UIImage,展示到界面上
NSNumber *isDegraded = info[PHImageResultIsDegradedKey];
if (!isDegraded.boolValue) {
result = [self fixImageOrientation:result];
ImageListModel *model = [ImageListModel modelWithUIImage:result];
[imageArray addObject:model];
}
}];
}
}];
}
return imageArray;
}
可以看到,这个方法有个很明显的缺陷,就是每次都是先请求了原图来判断是不是gif图片,当不是gif图片时再请求了一遍缩略图。目前,我也没想到其他比较好的处理方式 :(
gif图片上传
gif图片上传跟普通的图片上传大体上是一样的,唯一要注意的一点是文件的扩展名和mimeType
下面这段代码是我项目里使用的,因为服务端提供的图片上传接口支持批量上传(一次性上传多个图片),也许你的服务端接口可能会不一样,但是思想应该差不多。
说几点图片上传要注意的事项吧:
- name是需要跟服务端约定好的
- 原则上fileName没什么特殊要求,也不需要跟服务端统一,但是fileName的扩展名最好不要弄错,一般服务端都是会保留原格式(就是你这里指定的扩展名),尤其是gif图片,一定不要写成jpg等其他格式
- gif图片上传只能用NSData对象传参,不能通过UIImage对象。
/**
* 图片上传(ImageListModel数组)
*
* @param urlString 上传地址
* @param parameters 参数
* @param images ImageListModel数组
*/
- (NSURLSessionUploadTask *)upload:(NSString *)urlString
parameters:(id)parameters
images:(NSArray *)images
complete:(void (^)(ResponseData *response))complete {
NSMutableDictionary *params = [NSMutableDictionary dictionaryWithDictionary:parameters];
NSString *token = [UserDefaultHelper stringForKey:kUserDefaultUserToken];
if (token.length) {
[params safeValue:token forKey:@"token"];
}
NSMutableURLRequest *request = [[AFHTTPRequestSerializer serializer] multipartFormRequestWithMethod:@"POST" URLString:[NSString stringWithFormat:@"%@%@",BASE_URL_API,urlString] parameters:params constructingBodyWithBlock:^(id formData) {
NSString *name = @"upload[]";
NSInteger index=0;
for (ImageListModel *model in images) {
if (model.isGif) { //gif图片
[formData appendPartWithFileData:model.imageData name:name fileName:[NSString stringWithFormat:@"upload%@.gif",@(index++)] mimeType:@"image/gif"];
}
else {
if (model.imageData) {
[formData appendPartWithFileData:model.imageData name:name fileName:[NSString stringWithFormat:@"upload%@.jpg",@(index++)] mimeType:@"image/jpeg"];
}
else if (model.image) {
[formData appendPartWithFileData:UIImageJPEGRepresentation(model.image, 0.8) name:name fileName:[NSString stringWithFormat:@"upload%@.jpg",@(index++)] mimeType:@"image/jpeg"];
}
}
}
} error:nil];
request.timeoutInterval = kHttpRequestTimeoutInterval;
NSURLSessionUploadTask *uploadTask = [self uploadTaskWithStreamedRequest:request progress:^(NSProgress * _Nonnull uploadProgress) {
// DDLogDebug(@"upload progress:%@",uploadProgress);
} completionHandler:^(NSURLResponse * _Nonnull response, id _Nullable responseObject, NSError * _Nullable error) {
DDLogDebug(@"url:%@,param:%@,resp:%@",request.URL.absoluteString,params,responseObject);
if (error) {
[self handleError:error complete:complete];
}
else {
[self handleSuccess:responseObject complete:complete];
}
}];
[uploadTask resume];
return uploadTask;
}
gif图片展示
我相信大家的项目中一定不会少了SDWebImage这个库,有了这个,gif图片展示很简单。我们都知道可以利用下面这个方法来显示一个网络图片(或者它的变种方法):
- (void)sd_setImageWithURL:(NSURL *)url;
其实,我们不需要修改任何参数,还是这个方法,只要url是gif图片,用了这个方法UIImageView就能正常显示gif图片。
保存gif图片到相册里
保存gif图片也是一个原则,必须获取到图片的NSData,不能用UIImage。我用了SDWebImage里的SDWebImageDownloader来下载图片的NSData数据:
注:
- 9.0以上利用PHPhotoLibrary保存(因为PHAssetCreationRequest是iOS9.0才有的,这里加了一个宏判断,解决低版本SDK编译时报错的问题,__IPHONE_OS_VERSION_MAX_ALLOWED:这个值等于Base SDK,还有一个__IPHONE_OS_VERSION_MIN_REQUIRED:这个值等于Deployment Target,检查支持的最小系统版本)
- 9.0以下还是用了ALAssetsLibrary
//gif 图片
if ([imgUrl.absoluteString hasSuffix:@".gif"]) {
[[SDWebImageDownloader sharedDownloader] downloadImageWithURL:imgUrl options:SDWebImageDownloaderUseNSURLCache progress:nil completed:^(UIImage *image, NSData *data, NSError *error, BOOL finished) {
#if __IPHONE_OS_VERSION_MAX_ALLOWED >= 90000
if ([UIDevice currentDevice].systemVersion.floatValue >= 9.0f) {
[[PHPhotoLibrary sharedPhotoLibrary] performChanges:^{
PHAssetResourceCreationOptions *options = [[PHAssetResourceCreationOptions alloc] init];
options.shouldMoveFile = YES;
[[PHAssetCreationRequest creationRequestForAsset] addResourceWithType:PHAssetResourceTypePhoto data:data options:options];
} completionHandler:^(BOOL success, NSError * _Nullable error) {
dispatch_sync(dispatch_get_main_queue(), ^{
[self image:nil didFinishSavingWithError:error contextInfo:NULL];
});
}];
}
else {
ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init];
[library writeImageDataToSavedPhotosAlbum:data metadata:nil completionBlock:^(NSURL *assetURL, NSError *error) {
dispatch_sync(dispatch_get_main_queue(), ^{
[self image:nil didFinishSavingWithError:error contextInfo:NULL];
});
}];
}
#else
ALAssetsLibrary *library = [[ALAssetsLibrary alloc] init];
[library writeImageDataToSavedPhotosAlbum:data metadata:nil completionBlock:^(NSURL *assetURL, NSError *error) {
dispatch_sync(dispatch_get_main_queue(), ^{
[self image:nil didFinishSavingWithError:error contextInfo:NULL];
});
}];
#endif
}];
return;
}
结束语
好了,以上就是我一天来摸索gif所有涉及到的技术点了,希望对你有一丢丢帮助!如果写错了、有问题或者有更好的建议,非常欢迎你能指出来,我会及时改进!
另外,这里没法提供比较完整的demo了,因为中间涉及到服务端接口的配合,见谅!
最后,enjoy yourself!