AssetsLibrary.framework是iOS7.0之前用来获取手机所有的媒体资源的一个静态库,在iOS8.0之后完全可以用Photo.framework来代替,但因为涉及到适配iOS7,所以这个库用的还是比较多的。
实际上,多选图片有很多很好用的第三方,但找到一个完全符合自己需求的第三方也不是那么容易,就算找到,如果不懂,也不是很好修改代码才对,所以了解一下这个库也是很有必要的,这里就记录一下过程中的认识与问题。
如果小伙伴有什么好玩的库,还请介绍一下,很希望能和喜欢钻研技术的你们一起交流。
下面的内容是边看开发文档边研究使用,按自己的理解所写,如果出现错误,也请告知一下Thanks()
本文中的所有代码:https://github.com/YRunIntoLove/YAImagePickerView
研究一个库或者框架,总体逻辑一定是要缕清的,下面是个人的理解:
- ALAssetsLibrary 是一个资源库,所有的资源组最初都是从这个类的对象中获得.
- ALAssetsGroup 是一个资源组,里面包含了每个资源组的基本信息以及包含的所有资源,可以通过设置过滤器属性来选择自己想要的资源类型.
- ALAssetsFilter 是一个过滤器,比如需要从资源组中遍历出所有的资源,视频资源还是图片资源.
- ALAsset 是一个资源对象,里面可以取到组的信息,详细信息可以通过获取自身的详细对象来获取
- ALAssetRepresentation 是资源对象的详细信息,ALAsset的详细内容都存在这个类中,比如高清图就存在该对象中。
这里提到的都是代码中用到的属性和方法,如果只是为了多图选择,那么以下的方法应该是够用的,不够的话可以Command+单击
进入开发文档查看即可。
资源库对象:
/***相关类型***/
ALAssetsGroupLibrary //从iTunes 来的相册内容(如本身自带的向日葵照片)
ALAssetsGroupAlbum //设备自身产生或从iTunes同步来的照片,但是不包括照片流跟分享流中的照片。(例如从各个软件中保存下来的图片)
ALAssetsGroupEvent //相机接口事件产生的相册
ALAssetsGroupFaces //脸部相册(具体不清楚)
ALAssetsGroupSavedPhotos //"相册胶卷"里面的照片
ALAssetsGroupPhotoStream //照片流
ALAssetsGroupAll //除了ALAssetsGroupLibrary上面所的内容
/*遍历相关类型的资源组*/
- (void)enumerateGroupsWithTypes:(ALAssetsGroupType)types
usingBlock:(ALAssetsLibraryGroupsEnumerationResultsBlock)enumerationBlock
failureBlock:(ALAssetsLibraryAccessFailureBlock)failureBlock;
资源组对象:
/***属性的key***/
extern NSString *const ALAssetsGroupPropertyName ; //组的标题
extern NSString *const ALAssetsGroupPropertyType; //组的类型
extern NSString *const ALAssetsGroupPropertyPersistentID ; //组的代表ID
extern NSString *const ALAssetsGroupPropertyURL; //该组在本地存储的位置url
//获取相关属性的方法,property的值从上面的属性key中取即可
- (id)valueForProperty:(NSString *)property;
//获取资源组的预览图
- (CGImageRef)posterImage;
//设置过滤器
- (void)setAssetsFilter:(ALAssetsFilter *)filter;
//当前组的资源数,如果设置了过滤对象,此数目就是过滤之后存储资源对象的个数
- (NSInteger)numberOfAssets;
/***遍历资源的方法***/
//遍历所有的资源
- (void)enumerateAssetsUsingBlock:(ALAssetsGroupEnumerationResultsBlock)enumerationBlock;
//根据类型遍历
- (void)enumerateAssetsWithOptions:(NSEnumerationOptions)option
usingBlock:(ALAssetsGroupEnumerationResultsBlock)enumerationBlock;
//类型
typedef NS_OPTIONS(NSUInteger, NSEnumerationOptions) {
NSEnumerationConcurrent = (1UL << 0), //顺序(Default)
NSEnumerationReverse = (1UL << 1), //逆序
};
资源过滤器:
//获得组中所有的照片资源
+ (ALAssetsFilter *)allPhotos;
//获得组中所有的视频资源
+ (ALAssetsFilter *)allVideos;
//获得组中所有的资源
+ (ALAssetsFilter *)allAssets;
资源对象:
/***相关属性的key***/
extern NSString *const ALAssetPropertyType; //资源对象的类型
extern NSString *const ALAssetPropertyLocation; //资源对象的位置描述
extern NSString *const ALAssetPropertyDuration; //资源对象的持续时间(用于video类型的资源对象)
extern NSString *const ALAssetPropertyOrientation; //资源对象的方向,如:左转,右转..
extern NSString *const ALAssetPropertyDate; //资源对象的创建时间对象
extern NSString *const ALAssetPropertyRepresentations; //资源对象的可用详细对象数组
extern NSString *const ALAssetPropertyURLs; //资源对象的详细对象的URLs
extern NSString *const ALAssetPropertyAssetURL; //资源对象的资源标识码
/***相关类型的key***/
extern NSString *const ALAssetTypePhoto; //图片类型
extern NSString *const ALAssetTypeVideo; //视频类型
extern NSString *const ALAssetTypeUnknown; //位置类型
//获取相关属性的方法,property的值从上面的属性key中取即可,与ALAssertGroup是一样的
- (id)valueForProperty:(NSString *)property
//获取自身详细信息对象的一个便利方法
- (ALAssetRepresentation *)defaultRepresentation;
//获取一个方形的缩略图,但是不建议用,真是太模糊了
- (CGImageRef)thumbnail;
//获取一个按照比例缩放的缩略图,建议用这个,还是比较清晰的(Demo中的属性用的是这个属性)
- (CGImageRef)aspectRatioThumbnail;
资源详情对象:
//当前对象的方向
- (ALAssetOrientation)orientation;
//获得缩放比例
- (float)scale;
//获得一个铺满屏幕的高清图(Demo中预览的高清图就是取得这个属性)
- (CGImageRef)fullScreenImage;
//如果使用这个属性,直接用此方法生成UIImage对象
UIImage * image = [UIImage imageWithCGImage:fullScreenImage];
//获得一个重新处理的铺满屏幕的高清图
- (CGImageRef)fullResolutionImage;
//如果使用这个属性,需要用下面的方法生成UIImage对象,不然会出现展示方向等错误,比如图片显示会变成左转90度的
UIImage * image = [UIImage UIImage imageWithCGImage:fullResolutionImage
scale:fullResolutionImage.scale
orientation:fullResolutionImage.orientation];
//
// YEnumConfig.h
// YChoosePicturesDemo
//
// Created by YueWen on 16/4/15.
// Copyright © 2016年 YueWen. All rights reserved.
//
#ifndef YEnumConfig_h
#define YEnumConfig_h
@import UIKit;
@import AssetsLibrary;
#pragma mark -
typedef enum : NSUInteger {
YChoosePhotoSequenceTypeDefault = 0, //默认是按照选择的顺序
YChoosePhotoSequenceTypeDate //按照图片在相册的顺序
} YChoosePhotoSequenceType;
#pragma mark -
//照片选择的Block回调
typedef void(^ImagesBlock)(NSArray <UIImage *> *);
#pragma mark - YPhotoManager
typedef void(^ALAssetGroupBlock)(NSArray * groups);
typedef void(^ALAssetPhotoBlock)(NSArray * photos);
typedef void(^ALAssetFailBlock)(NSString * error);
#pragma mark - YPhotoCollectionViewCell
typedef void(^YPhotoCollectionViewBlock)(void);
#endif /* YEnumConfig_h */
按照习惯,还是创建了一个YPhotoManager
的单例
@interface YPhotoManager ()
@property (nonatomic, strong) ALAssetsLibrary * library; //资源库
@property (nonatomic, copy) ALAssetGroupBlock block; //资源组进行的回调
@property (nonatomic, strong) NSMutableArray * groups; //存放所有照片组的数组对象
@property (nonatomic, strong) NSMutableArray * photos; //存放所有照片的数组对象
@end
/**
* 创建组名叫做title的相片组
*
* @param title 组名
*/
- (void)createGroupWithTitle:(NSString *)title
{
//开始创建
[self.library addAssetsGroupAlbumWithName:title resultBlock:^(ALAssetsGroup *group) {
//coding success
} failureBlock:^(NSError *error) {
//coding error
}];
}
读取所有的资源组对象,其实就是枚举遍历,每次获得一个group对象都会进行一次回调,同步会略微卡顿,所以使用异步回调Block
#pragma mark - 读取相册的所有组
/**
* 读取相册的所有组
*
* @param groupBlock 获取组成功的回调
* @param failBlock 失败的回调
* @param cameraRollHandle 相机胶卷不为nil时候进行的回调
*/
-(void)readAllPhotoGroups:(ALAssetGroupBlock)groupBlock Fail:(ALAssetFailBlock)failBlock CameraRollHandel:(void (^)(void))cameraRollHandle
{
//删除之前存的所有组
[self.groups removeAllObjects];
__block __weak typeof(self) copy_self = self;
//开始遍历
[self.library enumerateGroupsWithTypes:ALAssetsGroupAll usingBlock:^(ALAssetsGroup *group, BOOL *stop) {
//如果返回的组存在
if (group)
{
//对group进行过滤,只要照片
[group setAssetsFilter:[ALAssetsFilter allPhotos]];
//添加数据
[copy_self.groups addObject:group];
//进行顺序判断,目的是将胶卷相册放到第一位
if([self containCameraRoll:group] == true)
{
//删除当前位置的数组
[self.groups removeObjectAtIndex:self.groups.count - 1];
[self.groups insertObject:group atIndex:0];
}
//回调数据
groupBlock([NSArray arrayWithArray:copy_self.groups]);
//进行序列后的回调
if([self containCameraRoll:group] == true)
cameraRollHandle();
}
} failureBlock:^(NSError *error) {
//失败回调
failBlock(error.localizedDescription);
}];
}
这里加载所有的组,所以相机胶卷那个组位置不会是第一个,但是又想它在第一行,增加这个判断来保证存在相机胶卷,为其他操作进行准备:
/**
* 判断是否包含相机胶卷
*
* @param group ALAssetsGroup对象
*
* @return true表示包含,false反之
*/
- (BOOL)containCameraRoll:(ALAssetsGroup *)group
{
//如果是相机胶卷,放到第一位,这里只适配英文以及中文
NSString * nameCN = NSLocalizedString([group valueForProperty:ALAssetsGroupPropertyName], @"");
NSString * nameEN = NSLocalizedString([group valueForProperty:ALAssetsGroupPropertyName], @"");
//对当前组数进行排序
if ([nameCN isEqualToString:@"相机胶卷"]
|| [nameEN isEqualToString:@"Camera Roll"])
{
//修改变量
return true;
}
return false;
}
1、要想请求组中的资源,首先要打开这个组对象
#pragma mark - 打开相片组
-(void)openPhotosGroup:(ALAssetsGroup *)assetsGroup Success:(ALAssetPhotoBlock)successBlock Fail:(ALAssetFailBlock)failBlock
{
//删除所有的照片对象
[self.photos removeAllObjects];
//避免强引用
__block __weak typeof(self) copy_self = self;
//获取当前组的url数据
NSURL * url = [assetsGroup valueForProperty:ALAssetsGroupPropertyURL];
//打开当前的资源组对象
[self.library groupForURL:url resultBlock:^(ALAssetsGroup *group) {
[copy_self photosInGroups:group Block:successBlock];
} failureBlock:^(NSError *error) {
//失败的回调
failBlock(error.localizedDescription);
}];
}
2、在打开的组里面进行遍历并回调数据
//获取所有的照片对象并回调数据
- (void)photosInGroups:(ALAssetsGroup *)group Block:(ALAssetPhotoBlock)photoBlock
{
//开始读取
[group enumerateAssetsUsingBlock:^(ALAsset *result, NSUInteger index, BOOL *stop) {
//如果不为空或者媒体为图片
if (result != nil && [[result valueForProperty:ALAssetPropertyType] isEqualToString:ALAssetTypePhoto])
{
//添加数据
[self.photos addObject:result];
//数目达标后统一进行回调
if (index == group.numberOfAssets - 1)
{
//回调
photoBlock([NSArray arrayWithArray:self.photos]);
}
}
}];
}
用到的数据基本都谢了,至于View以及ViewController因为太长,就不在这里占地方了,如果有想法,可以下载代码研究一下。
最后还是要唠叨一句,不管是UIImageView还是UIButton,显示缩略图的时候不要忘记设置contentMode属性,这样才会出现选择展示图中的效果:
//这里表示如果图太大,根据高宽中的最大数值进行展示,所以会有一部分不显示
UIViewContentModeScaleAspectFill
//他和上面的属性相反,它是根据高宽终的最小数值进行展示
UIViewContentModeScaleAspectFit
//如果是CollectionCell中进行展示的,设置如下
Self.contentMode = UIViewContentModeScaleAspectFill;
//如果是浏览高清图的时候,设置如下
Self.contentMode = UIViewContentModeScaleAspectFit;