版权声明:本文为博主原创文章,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接。
Photos.framework是iOS8后苹果推出的一套替代AssetsLibrary.framework获取相册资源的原生库,至于AL库,欢迎大家给博文iOS开发——简单实现图片多选功能(AssetsLibrary.framework篇)提出宝贵的意见。
楼主大部分都是查看官方开发文档进行探索的(当然,实在不明白了也会请求google 的 0.0 )。这里就说一下个人的看法吧,相比AL库,Photos的开发文档显然更像是目前我们接触的ObjC语言(如果不信,可以对比一下AL库和Photos库的开发文档)。初次接触这个库的时候可能会感觉比较乱,毕竟类的数量比AL库多了好多,但在熟悉大体逻辑之后,就会发现它的分工比AL更加明确,并且使用起来要比AL灵活的多。
提醒一下,要使用相册资源库的时候,为了适配一下将来的iOS10,不要忘记在info.plist文件中加入NSPhotoLibraryUsageDescription
这个描述字段啊,更多的权限坑请关注一下博文 iOS开发——iOS 10 由于权限问题导致崩溃的那些坑
Demo全代码 : https://github.com/RITL/RITLImagePickerDemo
话说的有点多了,下面就谈谈个人对Photos的理解,这里只记录一下Photos.framework中类的使用与理解,真正的实现多选功能请前去上面的链接下载demo查看,多谢指正:
研究一个库或者框架,总体逻辑一定是要缕清的,下面就是个人对photos的理解,有点多,分类一下吧:
类方法
获得想要的相册集合,继承自PHCollection.类方法
对PHCollection对象进行遍历,获得存放Asset对象的结果集,可以直接获得资源的规格数据,若想获得图片以及原图等资源,需要配合PHImageManager对象,继承自PHObject.这里提到的都是代码中用到的属性和方法,如果只是为了多图选择,那么以下的方法应该是够用的,不够的话可以Command+单击进入开发文档查看即可。
我觉得下面的方法应该都懂,毕竟每个涉及到权限的库都会存在下面三个方法的.
// 获得单例对象
+ (PHPhotoLibrary *)sharedPhotoLibrary;
// 获得相册权限
+ (PHAuthorizationStatus)authorizationStatus;
//请求权限
+ (void)requestAuthorization:(void (^)(PHAuthorizationStatus status))handler;
之前说请求类不能独自使用,需要配合PHPhotoLibrary对象,为什么这么说呢,是因为在使用请求类的时候必须使用下面两个方法其中之一,下面是开发文档的一句话:
/*表示请求只能通过下面两种方法的block进行创建和使用,所有的ChangeRequest类上面都会存在这句话,当然类名肯定不一样的.*/
PHAssetCollectionChangeRequest can only be created or used within a -[PHPhotoLibrary performChanges:]
or -[PHPhotoLibrary performChangesAndWait:] block.
// 异步执行change的变化请求
- (void)performChanges:(dispatch_block_t)changeBlock completionHandler:(void (^)(BOOL success, NSError *__nullable error))completionHandler;
//同步执行change的请求变化
- (BOOL)performChangesAndWait:(dispatch_block_t)changeBlock error:(NSError *__autoreleasing *)error;
其实我感觉只看上面的两个方法感觉会比较抽象,那么就拿出Demo中的两段小源码举个例子,相信这样就比较好理解了.
//新建一个名字叫做title的相册
-(void)addCustomGroupWithTitle:(NSString *)title
completionHandler:(void (^)(void))successBlock
failture:(void (^)(NSString * _Nonnull))failtureBlock
{
[self.photoLibaray performChanges:^{
// 创建一个创建相册的请求
[PHAssetCollectionChangeRequest creationRequestForAssetCollectionWithTitle:title];
}completionHandler:^(BOOL success, NSError * _Nullable error) {
if (success == true) // 成功
{
successBlock();
}
// 失败
failtureBlock(error.localizedDescription);
}];
}
// 向collection中添加图片
-(void)addCustomAsset:(UIImage *)image
collection:(PHAssetCollection *)collection
completionHandler:(void (^)(void))successBlock
failture:(void (^)(NSString * _Nonnull))failtureBlock
{
// 执行变化请求
[self.photoLibaray performChanges:^{
// 如果相册允许操作
if ([collection canPerformEditOperation:PHCollectionEditOperationAddContent])
{
// 创建资源请求对象
PHAssetChangeRequest * assetChangeRequest = [PHAssetChangeRequest creationRequestForAssetFromImage:image];
// 创建相册请求对象
PHAssetCollectionChangeRequest * groupChangeRequest = [PHAssetCollectionChangeRequest changeRequestForAssetCollection:collection];
// 向相册中添加资源
[groupChangeRequest addAssets:@[assetChangeRequest.placeholderForCreatedAsset]];
}
}completionHandler:^(BOOL success, NSError * _Nullable error) {
if (success == true) // 成功
{
successBlock(); return;
}
// 失败
failtureBlock(error.localizedDescription);
}];
}
// 这里不止能够通过图片对象创建,还存在如下两种创建方法
+ (nullable instancetype)creationRequestForAssetFromImageAtFileURL:(NSURL *)fileURL; // 通过图片所在的路径url进行创建
+ (nullable instancetype)creationRequestForAssetFromVideoAtFileURL:(NSURL *)fileURL; // 通过视频所在的路径url进行创建
// 组的标题,比如Camera Roll(胶卷相册)
@property (nonatomic, strong, readonly, nullable) NSString *localizedTitle;
// 资源组的类型,比如是智能相册,普通相册还是外界创建的相册
PHAssetCollectionType assetCollectionType;
typedef NS_ENUM(NSInteger, PHAssetCollectionType) {
PHAssetCollectionTypeAlbum = 1, // 传统相册
PHAssetCollectionTypeSmartAlbum = 2, // 智能相册
PHAssetCollectionTypeMoment = 3, // 自定义创建的相册
} NS_ENUM_AVAILABLE_IOS(8_0);
// 具体的子类型,比如是智能相册的自拍还是喜爱等,这个枚举类太多,就不进行粘贴了.
PHAssetCollectionSubtype assetCollectionSubtype;
// 资源组中资源的大约数量,不一定准,如果想要确切的,获得PHFetchResult对象取count即可
NSUInteger estimatedAssetCount;
// 最早的一张图片存在相册的时间
NSDate *startDate;
// 最近的一张图片存在相册的时间
NSDate *endDate;
// 判断是否能够进行编辑,如果是进行修改请求,最好通过这个方法来判断是下
- (BOOL)canPerformEditOperation:(PHCollectionEditOperation)anOperation;
// 获得智能分组,比如胶卷相册,最近添加,自拍等
PHFetchResult * smartGroups = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeSmartAlbum
subtype:PHAssetCollectionSubtypeAlbumRegular
options:nil];
// 获得我们自定义创建的相册组,比如有QQ的手机应该都会有QQ这个相册,那么通过该方法就可以获取的到
+ (PHFetchResult *)fetchTopLevelUserCollectionsWithOptions:(nullable PHFetchOptions *)options;
如果PHFetchResult觉得用起来不是很爽的话,可以将其包装成数组来进行下一步的操作,Demo中就是将其打包成数组来进行操作的:
@implementation PHFetchResult (NSArray)
// 将PHFetchResult对象转成NSArray对象
-(void)transToArrayComplete:(void (^)(NSArray * _Nonnull, PHFetchResult * _Nonnull))arrayObject
{
__weak typeof(self) weakSelf = self;
NSMutableArray * array = [NSMutableArray arrayWithCapacity:0];
if (self.count == 0)
{
arrayObject([array mutableCopy],weakSelf);
array = nil;
return;
}
[self enumerateObjectsUsingBlock:^(id _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
[array addObject:obj];
// 如果遍历完毕,进行回调
if (idx == self.count - 1)
{
arrayObject([array mutableCopy],weakSelf);
}
}];
}
@end
// 资源媒体的类型
PHAssetMediaType mediaType;
typedef NS_ENUM(NSInteger, PHAssetMediaType) {
PHAssetMediaTypeUnknown = 0, // 未知类型
PHAssetMediaTypeImage = 1, // 图片类型
PHAssetMediaTypeVideo = 2, // 视频类型
PHAssetMediaTypeAudio = 3, // 音频类型
} NS_ENUM_AVAILABLE_IOS(8_0);
// 资源美图的子类型,比如如果资源是图片,那么它是全景还是HDR,如果是iOS9,还能知道他是屏幕截图还是live图片,枚举有点多,也不再次粘贴了.
PHAssetMediaSubtype mediaSubtypes;
// 资源的像素宽
NSUInteger pixelWidth;
// 资源的像素高
NSUInteger pixelHeight;
// 资源的创建日期
NSDate *creationDate;
// 资源的最近一次修改的时间
NSDate *modificationDate;
// 资源拍摄的地点
CLLocation *location;
// 如果是音频或者视频,它的持续时间
NSTimeInterval duration;
// 它是否被隐藏
BOOL hidden;
// 它是否是喜爱的
BOOL favorite;
// 请求图片,将想要获取Image实体的资源,裁剪的大小以及方式进行获取图片
// 如果想要原图,设置PHImageRequestOptions对象的deliveryMode属性为PHImageRequestOptionsDeliveryModeHighQualityFormat即可
[[PHImageManager defaultManager]requestImageForAsset:asset
targetSize:size
contentMode:PHImageContentModeAspectFill
options:option
resultHandler:^(UIImage * _Nullable result, NSDictionary * _Nullable info) {
// 通过block回传图片,并将部分信息存在于info字典中,并且该方法的返回值可以在info字典中找到
}];
// 请求数据,获取资源的Data对象,可以用来计算资源的大小。
// 这样可以避免UIImage->Data导致内存以及CPU瞬间激增
[[PHImageManager defaultManager]requestImageDataForAsset:asset
options:option
resultHandler:^(NSData * _Nullable imageData, NSString * _Nullable dataUTI, UIImageOrientation orientation, NSDictionary * _Nullable info) {
// 在block里面获取图片的各种信息
}]; // 这里最好存在一个标位置或者其他方法标志一下,避免每次都要缓存导致的卡顿以及CPU卡死
[((PHCachingImageManager *)[PHCachingImageManager defaultManager])startCachingImagesForAssets:@[copy_self]
targetSize:newSize
contentMode:PHImageContentModeAspectFill
options:nil];
表示乍一看,是不是和数组很相似呀.
属性
// 当前集合的数量
NSUInteger count;
// 获得index位置的对象
- (ObjectType)objectAtIndex:(NSUInteger)index;
// 是否包含对象
- (BOOL)containsObject:(ObjectType)anObject;
// 对象的索引
- (NSUInteger)indexOfObject:(ObjectType)anObject;
// 第一个对象
ObjectType firstObject;
// 最后一个对象
ObjectType lastObject;
/*使用Block进行枚举遍历,stop控制是否停止,每次获得数据都会执行一次回调*/
- (void)enumerateObjectsUsingBlock:(void (^)(ObjectType obj, NSUInteger idx, BOOL *stop))block;
/*根据枚举类型进行枚举,比如正序还是倒序*/
- (void)enumerateObjectsWithOptions:(NSEnumerationOptions)opts usingBlock:(void (^)(ObjectType obj, NSUInteger idx, BOOL *stop))block;
/*枚举特定区间并按照响应枚举类型进行遍历*/
- (void)enumerateObjectsAtIndexes:(NSIndexSet *)s options:(NSEnumerationOptions)opts usingBlock:(void (^)(ObjectType obj, NSUInteger idx, BOOL *stop))block;
使用PHPhotoLibrary对象注册观察者,当然,不要在dealloc或者特定的地方注销观察者啊,与KVO相同.
// 注册观察者
- (void)registerChangeObserver:(id)observer;
// 注销观察者
- (void)unregisterChangeObserver:(id)observer;
PHPhotoLibraryChangeObserver
协议方法
// This callback is invoked on an arbitrary serial queue.
// If you need this to be handled on a specific queue,
// you should redispatch appropriately.
// 这个回调是在一个随意的线程中被唤起,如果需要在一个特定的线程中处理,应该在合适的地方重新唤起
// (翻译可能不太准确,如果需要更新,一般情况需要在主线程,这个应该都懂得.)
- (void)photoLibraryDidChange:(PHChange *)changeInstance;
具体用法如下:
首先需要查看是否发生了变化,如果没有变化,那么就返回nil;如果发生了变化,就会返回响应类型的对象:
// PHChange对象的两个方法:
// 获取PHObject对象的变化详情,其实PHAsset和PHCollection都是继承自PHObject的
- (nullable PHObjectChangeDetails *)changeDetailsForObject:(PHObject *)object;
-
// 获取结果集的变化详情,和上面一样,如果不存在变化,返回nil
- (nullable PHFetchResultChangeDetails *)changeDetailsForFetchResult:(PHFetchResult *)object;
// PHChange对象的两个方法:
// 获取PHObject对象的变化详情,其实PHAsset和PHCollection都是继承自PHObject的
- (nullable PHObjectChangeDetails *)changeDetailsForObject:(PHObject *)object;
-
// 获取结果集的变化详情,和上面一样,如果不存在变化,返回nil
- (nullable PHFetchResultChangeDetails *)changeDetailsForFetchResult:(PHFetchResult *)object;
下面记录一下描述详细变化的类吧:
// PHObject对象变化详情对象
PHObjectChangeDetails.h
// 变化之前的对象
@property (atomic, strong, readonly) __kindof PHObject *objectBeforeChanges;
// 变化之后的对象,
@property (atomic, strong, readonly, nullable) __kindof PHObject *objectAfterChanges;
// 内容是否发生了变化
@property (atomic, readonly) BOOL assetContentChanged;
// 该对象是否已经删除
@property (atomic, readonly) BOOL objectWasDeleted;
@end
/*
1、判断一下是否被删除了,如果被删除了,那么请把数据源的该对象也删除了吧,并重新reload一下当前的视图.
2、如果没有被删除,就可以知道是否发生了变化,那么,获取变化后的内容对象并将之前的内容replace一下,刷新视图即可
*/
// PHObject对象变化详情对象
PHObjectChangeDetails.h
// 变化之前的对象
@property (atomic, strong, readonly) __kindof PHObject *objectBeforeChanges;
// 变化之后的对象,
@property (atomic, strong, readonly, nullable) __kindof PHObject *objectAfterChanges;
// 内容是否发生了变化
@property (atomic, readonly) BOOL assetContentChanged;
// 该对象是否已经删除
@property (atomic, readonly) BOOL objectWasDeleted;
@end
/*
1、判断一下是否被删除了,如果被删除了,那么请把数据源的该对象也删除了吧,并重新reload一下当前的视图.
2、如果没有被删除,就可以知道是否发生了变化,那么,获取变化后的内容对象并将之前的内容replace一下,刷新视图即可
*/
// PHFetchResult对象发生变化的详情类
PHFetchResultChangeDetails.h
// 变化之前的结果集
@property (atomic, strong, readonly) PHFetchResult *fetchResultBeforeChanges;
// 变化之后的结果集
@property (atomic, strong, readonly) PHFetchResult *fetchResultAfterChanges;
/*
这个变量很有意思:
如果为true,表示集合发生了增删改,那么通过一下面的删除、新增以及更新操作的响应属性或方法进行数据的修改即可。
如果为false,则表示发生了大的改变,不在提供下面那些变化的详情,只能使用fetchResultAfterChanges属性对该属性进行替换即可*/
@property (atomic, assign, readonly) BOOL hasIncrementalChanges;
// 如果是删除操作,返回删除的位置以及删除的对象
@property (atomic, strong, readonly, nullable) NSIndexSet *removedIndexes;
@property (atomic, strong, readonly) NSArray<__kindof PHObject *> *removedObjects;
// 如果是新增操作,返回新增的位置以及新增的对象
@property (atomic, strong, readonly, nullable) NSIndexSet *insertedIndexes;
@property (atomic, strong, readonly) NSArray<__kindof PHObject *> *insertedObjects;
// 如果是更新操作,返回更新的位置以及更新的对象
@property (atomic, strong, readonly, nullable) NSIndexSet *changedIndexes;
@property (atomic, strong, readonly) NSArray<__kindof PHObject *> *changedObjects;
/*
1、判断一下hasIncrementalChanges值,如果为false,直接取fetchResultAfterChanges属性进行值的替换
2、如果为true,根据下面的详情数据进行相应操作即可,当然,使用全体替换的方法也是可以的,但是单个操作可以使用动画哦
*/
我要开始吐槽啦!其实毕业回学校的时候无聊,想练习一下Swift,研究过这个库,大体的功能与博文Demo的功能差不多,但由于起名太随便,随手删了,没错..删了!(还真是感谢我随手清理垃圾篓的习惯,呵呵….所以大家一定要不忘记备份呀,= = 再就是起名不要太随便啊),这个Demo是趁工作的业余时间写的,目的是加深对Photos库理解的同时不辜负学校的那段时间,不太建议直接拿本文的Demo直接放入工程中使用哦,Demo的目的只是为了学习一下Photos库,尽管对Demo进行了一些内存泄露的处理,但每次还是会有大约1MB多的内存多余占用,这个问题会在之后楼主不断进步的过程中进行修复的
记录完毕3Q
原文出自 : http://blog.csdn.net/runintolove/article/details/52024806