一.引言
最近项目中要用到相册和选取截图,但是系统的不太符合设计要求,所以就自己实现了一个.
首先说说做前普及的知识.在iOS中,关于相册的系统 API有两个,准确来说其实是一个.分别为AssetsLibrary和Photos,AssetsLibrary框架是iOS7之前的关于相册的系API,而在iOS8的时候由于AssetsLibrary框架的一些问题.所以苹果推出了新的API:Photos,知道iOS9的时候直接已经废弃了AssetsLibrary框架,但是我们在项目还要兼容iOS7,所以要对这两个分别来配置下.
二. AssetsLibrary框架
AssetsLibrary框架是 iOS7之前的相册系统框架,iOS9已被废弃,相似于一个数据集合,而想要获得某类型的照片或者照片组就得按照相应的规则去遍历数据集合,来获得想要的.这样的性能是不是太好.接下来看看主要组成该框架的类.
保存类api 是以write开头的一些 api
- (void)writeImageToSavedPhotosAlbum:(CGImageRef)imageRef
orientation:(ALAssetOrientation)orientation
completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
保存一个图片到相册:
imageRef:保存的图片, CGImageRef类型,可由[UIImage CGImage]获得
orientation:保存图片时,图片的方向,可由[UIImage imageOrientation]或得,枚举:
ALAssetOrientationUp 上
ALAssetOrientationDown 下
ALAssetOrientationLeft 左
ALAssetOrientationRight 右
ALAssetOrientationUpMirrored 水平上翻转
ALAssetOrientationDownMirrored 水平下翻转
ALAssetOrientationLeftMirrored 竖直左翻转
ALAssetOrientationRightMirrored 竖直右翻转
completionBlock:回调 block, 定义为:typedef void (^ALAssetsLibraryWriteImageCompletionBlock)(NSURL *assetURL, NSError *error)
成功回调得到 iamge 的 url.这里的 url 是本地的,可以用它来检索 image,error: 回调到错误信息.
其他保存 aip 类似.
读取类 api,这说下常用的遍历ALAssetsLibrary集合的.
- (void)enumerateGroupsWithTypes:(ALAssetsGroupType)types
usingBlock:(ALAssetsLibraryGroupsEnumerationResultsBlock)enumerationBlock
failureBlock:(ALAssetsLibraryAccessFailureBlock)failureBlock;
遍历资源集合获得筛选到的相册:
types:删选条件,枚举:
ALAssetsGroupLibrary 所有的相册(宝库本地和 iTunes 的)
ALAssetsGroupAlbum 同步得到iTunes的和创建的(不包括共享的)
ALAssetsGroupEvent 同步到 iTunes 的(包括相机导入的)
ALAssetsGroupFaces 同步 iTunes 的
ALAssetsGroupSavedPhotos 所有相册(包括相机导入的)
ALAssetsGroupPhotoStream itunes 同步的(包括共享的)
ALAssetsGroupAll 所有可见的相册
enumerationBlock:成功回调 block, 定义:typedef void (^ALAssetsLibraryGroupsEnumerationResultsBlock)(ALAssetsGroup *group, BOOL *stop)
获得 group: 每个图片或视屏组成的相册,stop: 停止遍历的标示
failureBlock:失败的回调:定义:typedef void (^ALAssetsLibraryAccessFailureBlock)(NSError *error)
error: 错误信息.
权限设置类:
+ (ALAuthorizationStatus)authorizationStatus;
类方法,返回值一个ALAuthorizationStatus的枚举类型,来表明当时的用户权限状况.
ALAuthorizationStatusNotDetermined 用户还未做出选择
ALAuthorizationStatusRestricted 用户权限设置(如家长模式)
ALAuthorizationStatusDenied 明确选择过不允许获得权限
ALAuthorizationStatusAuthorized 同意获取
(1):获取相册数量:
- (NSInteger)numberOfAssets;
获取数量是和你的删选条件有关filter.
(2):删选条件:
- (void)setAssetsFilter:(ALAssetsFilter *)filter;
给定一个删选条件.
filter:删选的一个条件,ALAssetsFilter类型的类方法
+ (ALAssetsFilter *)allPhotos; 所有的图片
+ (ALAssetsFilter *)allVideos; 所有的视屏
+ (ALAssetsFilter *)allAssets; 所有的资源(包括图片和视频)
(3):相册封面照片:
- (CGImageRef)posterImage;
获得相册的封面照片,该返回的图片方向是正确的.
(4):返回相册的一些相关属性:
- (id)valueForProperty:(NSString *)property;
property:相册相关的一些属性,定义了常量:
extern NSString *const ALAssetsGroupPropertyName 相册的名称
extern NSString *const ALAssetsGroupPropertyType 相册的类型
extern NSString *const ALAssetsGroupPropertyPersistentID 相册的标示 id
extern NSString *const ALAssetsGroupPropertyURL 相册的 url
(5):获取相册中的资源:
- (void)enumerateAssetsUsingBlock:(ALAssetsGroupEnumerationResultsBlock)enumerationBlock;
enumerationBlock:遍历资源回调的 block, 定义为:typedef void (^ALAssetsGroupEnumerationResultsBlock)(ALAsset *result, NSUInteger index, BOOL *stop);
result:一个图片或者资源的类,包含了资源的一些信息.
index:遍历相册时result 对应的下标位置.
stop:对遍历的操作控制.如果有特殊条件可以在某个位置停止获取资源.
(1):返回一个ALAssetRepresentation对象,一个ALAsset对像默认有一个ALAssetRepresentation对象,用他来获取更加详细的每个具体资源的信息,如:原图,大小,字节等.
- (ALAssetRepresentation *)defaultRepresentation;
(2):获得缩略图:
- (CGImageRef)thumbnail;
该方法获得相对质量不高的缩略图,他是对原图进行从最中间进行正方形的裁剪.改图不是按比例缩小.图片的方向的正确的.
(3):获得缩略图:
- (CGImageRef)aspectRatioThumbnail;
和上面的方法得到的都是缩略图,但是不同的是他是按图片原先的比例按比例缩小的
(4).保存图片到相册:
- (void)writeModifiedImageDataToSavedPhotosAlbum:(NSData *)imageData metadata:(NSDictionary *)metadata completionBlock:(ALAssetsLibraryWriteImageCompletionBlock)completionBlock;
保存图片到相册:
imageData:要保存的图片流,
metadata:保存图片的元数据,一般为 nil,如果和前面的 imageData 冲突的话,会覆盖掉前面的信息,
completionBlock:保存完的 block 回调,定义为:typedef void (^ALAssetsLibraryWriteImageCompletionBlock)(NSURL *assetURL, NSError *error),
assetUrl: 保存成功后映射该相片的 url
error: 保存失败信息.
三.Photos 框架
Photos 是 iOS8时苹果新推出的一个关于系统相册的新框架.改框架应该跟AssetsLibrary的处理不一样,他不是去根据条件遍历数据资源,而是根据条件直接获得指定的资源.所以相比而言,更加高效和完整.下来看看主要组成该框架的类.
(1).该相册的类型
assetCollectionType;
PHAssetCollectionType的枚举值:
PHAssetCollectionTypeAlbum 相册 //这是里对应的 PHAssetCollectionSubtype 用户自定义的相册文件也在其subtype
PHAssetCollectionTypeSmartAlbum 智能相册 //对应的为系统里的相册文件 下面的200- 211等都为其subtype
PHAssetCollectionTypeMoment 时刻
(2).该相册的子类型
assetCollectionSubtype;
PHAssetCollectionSubtype枚举类型:
常规的子类型
PHAssetCollectionSubtypeAlbumRegular 常规的
PHAssetCollectionSubtypeAlbumSyncedEvent 使用 iTunes 同步操作过来的相册
PHAssetCollectionSubtypeAlbumSyncedFaces 使用 iTuens同步操作过来的人物相册
PHAssetCollectionSubtypeAlbumSyncedAlbum 使用iTunes 同步的所有相册
PHAssetCollectionSubtypeAlbumImported 从外界导入的相册
经分享的子类型
PHAssetCollectionSubtypeAlbumMyPhotoStream 从相册分享得到
PHAssetCollectionSubtypeAlbumCloudShared 从 cloud 分享得到
智能相册子类型
PHAssetCollectionSubtypeSmartAlbumGeneric 通用的
PHAssetCollectionSubtypeSmartAlbumPanoramas 全景
PHAssetCollectionSubtypeSmartAlbumVideos 视屏
PHAssetCollectionSubtypeSmartAlbumFavorites 收藏
PHAssetCollectionSubtypeSmartAlbumTimelapses 延时视屏,也会在PHAssetCollectionSubtypeSmartAlbumVideos在出现
PHAssetCollectionSubtypeSmartAlbumAllHidden 隐藏的
PHAssetCollectionSubtypeSmartAlbumRecentlyAdded 最近添加
PHAssetCollectionSubtypeSmartAlbumBursts 连拍
PHAssetCollectionSubtypeSmartAlbumSlomoVideos Slomo是slow motion的缩写,高速摄影慢动作解析
PHAssetCollectionSubtypeSmartAlbumUserLibrary 用户所有的资源
PHAssetCollectionSubtypeSmartAlbumSelfPortraits 所有前置摄像头拍的照片和视屏
PHAssetCollectionSubtypeSmartAlbumScreenshots 所有的截屏图
不关心子类型时的全部资源
PHAssetCollectionSubtypeAny = NSIntegerMax
(3).获得相册的集合资源
+ (PHFetchResult *)fetchAssetCollectionsWithType:(PHAssetCollectionType)type subtype:(PHAssetCollectionSubtype)subtype options:(nullable PHFetchOptions *)options;
返回一个相册集合资源,集合里面是PHAssetCollection类型的对象.
type:相册类型, PHAssetCollectionType类型的枚举,
subtype:子类型, PHAssetCollectionSubtype的枚举,
PHFetchOptions: PHFetchOptions的一个实例,可以为空,只要是为了对获得资源做一些配置和排序等.可以为 nil.
(1).排序
sortDescriptors;
(2).是否显示隐藏的相册,默认不显示
includeHiddenAssets
(3).获取到相册的类型
includeAssetSourceTypes;
PHAssetSourceType类型的枚举,默认PHAssetSourceTypeNone
PHAssetSourceTypeNone 都没有,就获得到就是常规的
PHAssetSourceTypeUserLibrary 用户所有的
PHAssetSourceTypeCloudShared 分享的
PHAssetSourceTypeiTunesSynced iTunes 同步的
(1).相册中图片的数量
count
(2).遍历得到相册资源中每个相册组的信息.
- (void)enumerateObjectsUsingBlock:(void (^)(ObjectType obj, NSUInteger idx, BOOL *stop))block;
block为成功回调,定义为:void (^)(ObjectType obj, NSUInteger idx, BOOL *stop);
obj:改参数由遍历他的集合决定,如果是PHAssetCollection 的 api 获得.那么他就是PHAssetCollection的对象,包括每组相册的一些信息;
如果是PHAsset api 获得,那他就是 PHAsset 对象,包含具体的每张图片的信息.
idx:遍历时每组相册对应在集合中的下标.
stop:用于在某时刻停止遍历资源.
(1).资源的原信息.
mediaType:PHAssetMediaType类型的枚举值:
PHAssetMediaTypeUnknown 不知类型
PHAssetMediaTypeImage 图片
PHAssetMediaTypeVideo 视屏
PHAssetMediaTypeAudio 音频
(2).资源的子类型.
mediaSubtypes:PHAssetMediaSubtype类型的枚举值:
PHAssetMediaSubtypeNone 没有任何子类型
相片子类型
PHAssetMediaSubtypePhotoPanorama 全景图
PHAssetMediaSubtypePhotoHDR 滤镜图
PHAssetMediaSubtypePhotoScreenshot 截屏图
PHAssetMediaSubtypePhotoLive 1.5s 的 photoLive
视屏子类型
PHAssetMediaSubtypeVideoStreamed 流体
PHAssetMediaSubtypeVideoHighFrameRate 高帧视屏
PHAssetMediaSubtypeVideoTimelapse 延时拍摄视频
(3).获得 PHAsset 的集合.
+ (PHFetchResult *)fetchAssetsWithOptions:(nullable PHFetchOptions *)options;
(1).获得该实例.
+ (PHImageManager *)defaultManager;
(2).经删选和限制条件获得具体的资源UIImage.
- (PHImageRequestID)requestImageForAsset:(PHAsset *)asset
targetSize:(CGSize)targetSize
contentMode:(PHImageContentMode)contentMode
options:(nullable PHImageRequestOptions *)options resultHandler:(void (^)(UIImage *__nullable result, NSDictionary *__nullable info))resultHandler;
返回值: PHImageRequestID,是个常量,定义为:static const PHImageRequestID PHInvalidImageRequestID = 0;
asset:想要获得信息的PHAsset的对象,
targetSize:获得图片的尺寸大小,这里的大小是pixel,所以换算乘以[UIScreen mainScreen].scale.获得自己想要的尺寸.
如果想要原图的尺寸,直接传入PHImageManagerMaximumSize.很大很大的尺寸,系统会默认返回原图的尺寸,要注意的是传入PHImageManagerMaximumSize时,则 contentMode 无论传入什么值都会被视为PHImageContentModeDefault.
contentMode:想要图片的裁剪方式, PHImageContentMode的枚举:
PHImageContentModeAspectFit 适合的
PHImageContentModeAspectFill 铺满的
PHImageContentModeDefault = PHImageContentModeAspectFit
options: PHImageRequestOptions的实例,包括控制图片版本,质量,裁剪参数等的一个类.
resultHandler:成功回调block,
result:获取到的具体图片,
info:关于图片的一些信息,如是否来自 cloud, 是否是原图等.
(1).缓存操作.
- (void)startCachingImagesForAssets:(NSArray *)assets
targetSize:(CGSize)targetSize
contentMode:(PHImageContentMode)contentMode
options:(nullable PHImageRequestOptions *)options;
assets:要缓存获取 PHAsset 类型对象的集合.
targetSize:获取时的尺寸.
contentMode:裁剪方法,
options:传入的控制参数类.
(2).取消缓存操作.
- (void)stopCachingImagesForAssets:(NSArray *)assets targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(nullable PHImageRequestOptions *)options;
assets:要缓存获取 PHAsset 类型对象的集合.
targetSize:获取时的尺寸.
contentMode:裁剪方法,
options:传入的控制参数类.
(1).控制图片质量和获取速度的 api
deliveryMode.
PHImageRequestOptionsDeliveryMode类型的枚举,只有synchronous属性设置为 YES,即异步获取有限
PHImageRequestOptionsDeliveryModeOpportunistic 图片质量和获取速度均衡
PHImageRequestOptionsDeliveryModeHighQualityFormat 获取高质量图片,不保证获取速度
PHImageRequestOptionsDeliveryModeFastFormat 快速获得,不保证质量
(2).裁剪的方式
resizeMode.
PHImageRequestOptionsResizeMode类型的枚举:
PHImageRequestOptionsResizeModeNone 不设置
PHImageRequestOptionsResizeModeFast
返回的图像可能和目标大小不一样并且质量较低,但效率高.
PHImageRequestOptionsResizeModeExact
返回图像必须和目标大小相匹配,并且图像质量也为高质量图像
(1).获得实例
+ (PHPhotoLibrary *)sharedPhotoLibrary;
(2).获得当前用户授权情况
+ (PHAuthorizationStatus)authorizationStatus;
返回一个PHAuthorizationStatus类型的枚举:
PHAuthorizationStatusNotDetermined 用户还未选择
PHAuthorizationStatusRestricted 家长模式 不允许
PHAuthorizationStatusDenied 不同意访问
PHAuthorizationStatusAuthorized 同意访问
(3).在第一次获取时,系统提示选择完后的回调方法
+ (void)requestAuthorization:(void(^)(PHAuthorizationStatus status))handler;
handler:该 block 就是用户授权选择完后的回调,可获得用户选择的结果
四.项目
主要分为两个大模块.一起是获取相册中的图片,另一个为对获取的图片进行想要的尺寸裁剪.
//相片原图
@property (nonatomic, strong) NSMutableArray *fullPhotos;
//缩略图
@property (nonatomic, strong) NSMutableArray *thumbnails;
//相册列表资源
@property (nonatomic, strong) NSMutableArray *albums
/**
* 获取图片方法
*
* @param success 成功回调(分组列表,原图,缩略图)
* @param failure 失败回调(error)
*/
- (void)getPhotosSuccess:(void (^)(NSMutableArray *groupPhotos,
NSMutableArray *fullPhotos,
NSMutableArray *thumbnails))success
failure:(void (^)(NSError *error))failure;
在方法的实现内部,将耗时的操作放在子线程,比如读取相册资源等,吧主要的额回调提示等放在主线程.我们分 iOS8以下和 iOS8以上,在 iOS8以下,用的AssetsLibrary框架,将相片组的名称和数量记录下来:
[_albums addObject:[NSString stringWithFormat:@"%@(%li)张",[group valueForProperty:ALAssetsGroupPropertyName],group.numberOfAssets]];
AssetsLibrary框架可以直接提供缩略图,直接保存下缩略图:
[_thumbnails addObject:[UIImage imageWithCGImage:CGImage]];
保存原图,这个地方保存的时候要压缩下,不然相片一多就会内存警告,会 crash:
[_fullPhotos addObject:UIImageJPEGRepresentation([UIImage imageWithCGImage:imageReference], 0.4)];
下面是iOS8以上的,用 Photos 框架的将相册的名称记录下来:
[_albums addObject:obj.localizedTitle];
应为 Photos 采取的机制不一样,他是由条件直接获取到对应的资源,所以只要遍历得到资源,就会占用内存.在图片稍微一多就会 crash, 所以我们在这采用保存 PHAsset 对象的办法来解决这个crash, 这也是苹果官方所采用的解决办法.
PHFetchResult *assetsFetchResults = [PHAsset fetchAssetsWithOptions:nil];
[assetsFetchResults enumerateObjectsUsingBlock:^(PHAsset *_Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
[_thumbnails addObject:obj];
[_fullPhotos addObject:obj];
}];
这里要注意两点:
我们在得到回调的资源时,去对遍历操作做一次缓存.
if ([self.thumbnails.firstObject isKindOfClass:[PHAsset class]]) {
// 在资源的集合
_imageManager = [[PHCachingImageManager alloc] init];
//缓存操作
[_imageManager startCachingImagesForAssets:self.thumbnails
targetSize:PHImageManagerMaximumSize
contentMode:PHImageContentModeAspectFill
options:nil];
}
然后再在赋值的时候拿出记录的 PHAsset 对象,给相应的控件赋值.此处获取到的缩略图只要按照原图比例得到的小图,要是直接使用,会产生变形,所以我们还要讲此图进行裁剪,按宽高,或得图片正中间的一个正方向的图.
//赋值
if ([obj isKindOfClass:[PHAsset class]]){
PHImageRequestOptions *requestOptions = [[PHImageRequestOptions alloc] init];
//异步
requestOptions.synchronous = YES;
//速度和质量均衡//synchronous ture 时有效
requestOptions.deliveryMode = PHImageRequestOptionsDeliveryModeOpportunistic;
//尽快提供要求左右的尺寸图
requestOptions.resizeMode = PHImageRequestOptionsResizeModeExact;
// 遍历资源的集合,获取其中的图片
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
[_imageManager requestImageForAsset:obj
targetSize:CGSizeMake(125 * [UIScreen mainScreen].scale,
125 * [UIScreen mainScreen].scale)
contentMode:PHImageContentModeDefault
options:requestOptions
resultHandler:^(UIImage *result, NSDictionary *info) {
dispatch_async(dispatch_get_main_queue(), ^{
cell.imageView.image = [self wf_thumbnailsCutfullPhoto:result];
});
}];
});
}
//裁剪图片,此处裁剪为125*125大的图,即为我们的缩略图
- (UIImage *)wf_thumbnailsCutfullPhoto:(UIImage*)fullPhoto
{
CGSize newSize;
CGImageRef imageRef = nil;
if ((fullPhoto.size.width / fullPhoto.size.height) < 1) {
newSize.width = fullPhoto.size.width;
newSize.height = fullPhoto.size.width * 1;
imageRef = CGImageCreateWithImageInRect([fullPhoto CGImage], CGRectMake(0, fabs(fullPhoto.size.height - newSize.height) / 2, newSize.width, newSize.height));
} else {
newSize.height = fullPhoto.size.height;
newSize.width = fullPhoto.size.height * 1;
imageRef = CGImageCreateWithImageInRect([fullPhoto CGImage], CGRectMake(fabs(fullPhoto.size.width - newSize.width) / 2, 0, newSize.width, newSize.height));
}
return [UIImage imageWithCGImage:imageRef];
}
裁剪框效果图.png
- (UIImage *)private_captureImageFromView:(UIView *)view{
CGRect screenRect = CGRectMake((self.view.frame.size.width - rectWidth) / 2,
(self.view.frame.size.height - rectHeight) / 2,
rectWidth,
rectHeight);
UIGraphicsBeginImageContextWithOptions(screenRect.size, NO, [UIScreen mainScreen].scale);
CGContextRef context = UIGraphicsGetCurrentContext();
if (context == NULL){
return nil;
}
//copy 一份图形上下位文,用来操作
CGContextSaveGState(context);
//将当前图行位文进行矩阵变换
CGContextTranslateCTM(context, -screenRect.origin.x, -screenRect.origin.y);
if( [view respondsToSelector:@selector(drawViewHierarchyInRect:afterScreenUpdates:)]){
//捕捉当前快照
[view drawViewHierarchyInRect:view.bounds afterScreenUpdates:NO];
}else{
//layer 层渲染
[view.layer renderInContext:context];
}
//图形位文退出栈
CGContextRestoreGState(context);
UIImage *image = UIGraphicsGetImageFromCurrentImageContext();
UIGraphicsEndImageContext();
return image;
}
最后这里附上demo 的地址,有兴趣的小伙伴可以下载看看.! Demo.
修注:
在后面该项目中此模块时,发现存在内存问题.当图片很多,上千上万张,或者不停地一直滑动,就会出现 ReceiveMemoryWarning,直至程序 crash.
出现这个问题后,在网上调研了一些资料,终于定位到问题的所在.所出现的内存问题有两个:
解决方法:重新做了图片获取后的管理.引入了两个类. WFAlumbModel 和 WFCacheModel ,用于管理和交接在图片和控制器之间的工作.获取的方法改动为:
/**
获取相册的方法
@param success 成功获取到模型 model
*/
- (void)getCameraSuccess:(void (^)(WFCacheModel *))success;
此方法内部开辟子线程,先调用 WFCacheModel 的实例方法,将 PHFetchResult/ALAssetsLibrary 对象保存在 model 的 result 属性中.
- (WFCacheModel *)modelWithResult:(id)result{
WFCacheModel *model = [[WFCacheModel alloc] init];
model.result = result;
return model;
}
然后重写 result 的 set 方法,在 set 方法中调用 WFPhotoAlbum 的方法.
- (void)getAssetsFromFetchResult:(id)result
completion:(void (^)(NSArray *))completion;
在此方法中方法,创建 WFAlumbModel 对象,将 PHAsset/ALAsset 对象保存在 WFAlumbModel 的 asset 属性中.然后添加在数组中以 block 的方式返回赋值给 WFCacheModel 的 models 属性,然后在获取相册的方法中. success 成功回调到 属性 models 数组装有 asset 的 WFAlumbModel 的 WFCacheModel 的集合.这样的对所有的相关对象层级管理.分开管理.
在控制器回调到数据源.然后给 cell 赋值的时候.在 cell 中调用方法,返回 UIImage, 赋值就可以了.
- (PHImageRequestID)getPhotosWithAsset:(id)asset
originalImage:(BOOL)originalImage
completion:(void (^)(UIImage *))completion
解决办法:用完后释放该对象.
CGImageRelease(imageRef);
做完这些优化.现在内存问题已经不复存在了,性能也挺不错的.前面对相册管理的优化由于代码篇幅,没有详细的说明.有兴趣的小伙伴可以下载 demo 看看,地址还是前面的那个,没有变哦!
-- NORMAL --