PhotoKit
2017-05-26 本文已影响385人
堂吉诃德灬
PhotoKit的组成
PHAssetCollection：PHCollection的子类，代表一个相册或者一个时刻，或者一个智能相册（例如最近删除，视频列表，收藏等）
PHFetchResult:一系列资源的集合，也可以是相册或者图片的集合，PHAssetCollection的类方法返回的就是PHFetchResult
PHFetchOptions:获取资源时的参数，可以传nil，传nil默认使用系统的
PHAsset:代表照片库中的一个资源，跟ASset类似,通过PHAsset可以获取可保存资源
PHImageManager:用于处理资源的加载，加载资源的过程带有缓存处理，可以通过传入一个 PHImageRequestOptions 控制资源的输出尺寸等规格
PHImageRequestOptions: 如上面所说，控制加载图片时的一系列参数
ios8-photo-kit.png
PHPhotoLibrary
+ (PHPhotoLibrary *)sharedPhotoLibrary //获得实例
+ (PHAuthorizationStatus)authorizationStatus //获得当前用户授权情况
返回一个PHAuthorizationStatus类型的枚举:
PHAuthorizationStatusNotDetermined 用户还未选择
PHAuthorizationStatusRestricted 家长模式 不允许
PHAuthorizationStatusDenied 不同意访问
PHAuthorizationStatusAuthorized 同意访问
//在第一次获取时,系统提示选择完后的回调方法
+ (void)requestAuthorization:(void(^)(PHAuthorizationStatus status))handler;
handler:该 block 就是用户授权选择完后的回调,可获得用户选择的结果
PHAssetCollection
获得相册的集合资源
+ (PHFetchResult<PHAssetCollection *> *)fetchAssetCollectionsWithType:(PHAssetCollectionType)type subtype:(PHAssetCollectionSubtype)subtype options:(nullable PHFetchOptions *)options;
返回一个相册集合资源,返回的是PHFetchResult对象集合，集合里面是PHAssetCollection类型的对象.
type:相册类型, PHAssetCollectionType类型的枚举,
subtype:子类型, PHAssetCollectionSubtype的枚举,
PHFetchOptions: PHFetchOptions的一个实例,可以为空,主要是为了对获得资源做一些配置和排序等.可以为 nil.
PHAssetCollectionType:
PHAssetCollectionTypeAlbum //相册
PHAssetCollectionTypeSmartAlbum //智能相册
PHAssetCollectionTypeMoment //时刻
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
PHFetchResult
count 相册中图片的数量
//遍历相册资源中每个相册组的信息
- (void)enumerateObjectsUsingBlock:(void (^)(ObjectType obj, NSUInteger idx, BOOL *stop))block;
PHFetchOptions
对使用 PHAsset, PHCollection, PHAssetCollection, 和 PHCollectionLis 的方法时出入的参数,主要对获取到资源做一些配置和排序等,一般为 nil, 默认使用系统的.
sortDescriptors 排序
includeHiddenAssets 是否显示隐藏的相册,默认不显示
includeAssetSourceTypes; //获取到相册的类型
PHAssetSourceType类型的枚举,默认PHAssetSourceTypeNone
PHAssetSourceTypeNone 都没有,就获得到就是常规的
PHAssetSourceTypeUserLibrary 用户所有的
PHAssetSourceTypeCloudShared 分享的
PHAssetSourceTypeiTunesSynced iTunes 同步的
PHAsset
PHAsset:每个照片的详细信息
mediaType:资源的类型
//遍历获得PHAsset的集合
+ (PHFetchResult<PHAsset *> *)fetchAssetsInAssetCollection:(PHAssetCollection *)assetCollection options:(nullable PHFetchOptions *)options;
PHImageManager
PHImageManager：管理PHAsset的一个类，对资源进行管理和筛选
+ (PHImageManager *)defaultManager; //获得该实例.
//经删选和限制条件获得具体的资源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, 是否是原图等.
PHCachingImageManager
PHCachingImageManager是PHImageManager的子类，主要作用在获取图片的时候做缓存和清理的一个类
//缓存图片
- (void)startCachingImagesForAssets:(NSArray<PHAsset *> *)assets targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(nullable PHImageRequestOptions *)options;
assets:要缓存获取 PHAsset 类型对象的集合.
targetSize:想要缓存的尺寸.
contentMode:裁剪方法,
options:传入的控制参数类.
取消缓存操作.
- (void)stopCachingImagesForAssets:(NSArray<PHAsset *> *)assets targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(nullable PHImageRequestOptions *)options;
assets:要缓存获取 PHAsset 类型对象的集合.
targetSize:缓存的尺寸.
contentMode:裁剪方法,
options:传入的控制参数类.
PHImageRequestOptions
deliveryMode //控制图片质量和获取速度的 api
PHImageRequestOptionsDeliveryMode类型的枚举,只有synchronous属性设置为 YES,即异步获取有限
PHImageRequestOptionsDeliveryModeOpportunistic 图片质量和获取速度均衡
PHImageRequestOptionsDeliveryModeHighQualityFormat 获取高质量图片,不保证获取速度
PHImageRequestOptionsDeliveryModeFastFormat 快速获得,不保证质量
resizeMode //裁剪的方式
PHImageRequestOptionsResizeMode类型的枚举:
PHImageRequestOptionsResizeModeNone 不设置 PHImageRequestOptionsResizeModeFast 返回的图像可能和目标大小不一样并且质量较低,但效率高.
PHImageRequestOptionsResizeModeExact 返回图像必须和目标大小相匹配,并且图像质量也为高质量图像
代码范例：
PHFetchOptions
PHFetchOptions *option = [[PHFetchOptions alloc]init];
option.predicate = [NSPredicate predicateWithFormat:@"mediaType == %ld", PHAssetMediaTypeImage];
option.predicate = [NSPredicate predicateWithFormat:@"mediaType == %ld", PHAssetMediaTypeVideo];
option.sortDescriptors = @[[[NSSortDescriptor alloc]initWithKey:@"createDate" ascending:YES]];
PHAssetCollection(获取相册列表)
PHFetchResult *myPhotoStreamAlbum = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum subtype:PHAssetCollectionSubtypeAlbumMyPhotoStream options:nil];
PHFetchResult *smartAlbums = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeSmartAlbum subtype:PHAssetCollectionSubtypeAlbumRegular options:nil];
PHFetchResult *topLevelUserCollections = [PHCollectionList fetchTopLevelUserCollectionsWithOptions:nil];
PHFetchResult *syncedAlbums = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum subtype:PHAssetCollectionSubtypeAlbumSyncedAlbum options:nil];
PHFetchResult *sharedAlbums = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum subtype:PHAssetCollectionSubtypeAlbumCloudShared options:nil];
NSArray *allAlbums = @[myPhotoStreamAlbum,smartAlbums,topLevelUserCollections,syncedAlbums,sharedAlbums];
for(PHFetchResult *result in allAlbums)
{
for (PHAssetCollection *collection in result) {
//过滤掉非PHAssetCollection
if (![collection isKindOfClass:[PHAssetCollection class]]) {
continue;
}
PHFetchResult *assetResult = [PHAsset fetchAssetsInAssetCollection:collection options:option];
//如果相册里面没有资源过滤掉
if (assetResult.count <= 0) {
continue;
}
//过滤掉最近删除的
if ([collection.localizedTitle containsString:@"Deleted"] || [collection.localizedTitle isEqualToString:@"最近删除"])
{
continue;
}
[_albumArray addObject:collection];
}
}
}
PHImageManager
PHImageRequestOptions *option = [[PHImageRequestOptions alloc]init];
option.resizeMode = PHImageRequestOptionsResizeModeFast;
[[PHImageManager defaultManager]requestImageForAsset:asset targetSize:fsize contentMode:PHImageContentModeAspectFill options:option resultHandler:^(UIImage * _Nullable result, NSDictionary * _Nullable info) {
//这一块为什么要加BOOL值来判断呢，是因为有时候图片会从iCloud下载，这个时候这个block会回调多次，此时在block里面做的操作也会被执行多次，于是需要进行判断，当图片被取消或者错误或者低清图的时候不执行回调
BOOL downloadFinined = ![[info objectForKey:PHImageCancelledKey] boolValue] && ![info objectForKey:PHImageErrorKey] && ![[info objectForKey:PHImageResultIsDegradedKey] boolValue];
if (downloadFinined && result) {
if (noCut) {
completion ? completion(result) : nil;
}else
{
//这一块拿到的图片其实是原先的图片等比列缩小的，因为原先的图片宽和高不一定相等，所以图片会变形，需要进行处理
result = [self customImage:result];
completion ? completion(result) : nil;
}
}
}];
//将不合适的图片裁剪成合适的缩略图
-(UIImage*)customImage:(UIImage*)image
{
CGSize size;
if (image.size.width*1.0/image.size.height < 1) { //高比宽大，已宽为基准
size.width = image.size.width;
size.height = image.size.width;
//下面这段代码的意思是：因为高大于宽，所以y从中间裁剪
CGImageRef imageref = CGImageCreateWithImageInRect(image.CGImage, CGRectMake(0, fabs((image.size.height - image.size.width)/2.0), size.width, size.height));
return [UIImage imageWithCGImage:imageref];
}else //宽比高大
{
size.width = image.size.height;
size.height = image.size.height;
//下面这段代码的意思是：因为高大于宽，所以y从中间裁剪
CGImageRef imageref = CGImageCreateWithImageInRect(image.CGImage, CGRectMake( fabs((image.size.width - image.size.height)/2.0),0, size.width, size.height));
return [UIImage imageWithCGImage:imageref];
}
}
