Photos中常用类(获取展示功能相关)简介
简介
Photos framework是iOS8苹果提供的新的图片框架，能直接获取图片和视频，包括iCloud上面的图库。使用这个框架可以获取assets来展示和回放，编辑图片或者视频内容，或者使用系统相册、时刻、和分享到iCloud的相册来进行相关操作，本文侧重相片的获取与保存。
新特性与一些概念
获取实体&改变请求：
Photos framework中的三个model类：PHAsset,PHAssetCollection,PHCollectionList，分别对应三个类型的实体：asset(图片和视频)，assets集合（相册和时刻）,集合列表（相册文件夹或者moment clusters）。这些对象，也成为 相片实体（photo entities），只包含元数据，同时也是read-only属性。
改变观察机制：
使用这个特性能够在其他app、设备更改了图片和视频内容或者相册的时候通知你的app，在实现观察机制前需要用PHPhotoLibrary对象先为你获取到的照片实体注册一个观察者
支持手机中的照片app的特性
使用PHCollectionList类查找获取照片中响应的时刻层级asset，使用PHAsset标记连拍照片，全景照片和高分辨率视频等。当开启iCloud图库后，Photo framework能从iCloud中获取到使用相同apple ID登陆的不同设备中的照片。
加载缓存asset和缩略图
使用PHImageManager请求asset中的特定尺寸的图片或者通过AV Foundation 对象获取video asset。Photos frame会根据设定自动下载，缓存，以便于高效复用。对于大量的assets的快速执行，例如在生成相册中所有图片的缩略图时，使用PHCachingImageManager的子类来实现。
编辑asset内容
PHAsset和PHAsssetChangeRequest定义了一些用于编辑照片或者视频内容的方法，同时允许将编辑后的图片保存到图库中。为了可以让用户可以在前次修改的基础上再次修改，或者是在不同的app上进行多次修改，Photos保存了当前和县区版本的asset，如果单独使用PHAdjustMnentData对象只能获取到最后编辑的照片。如果你的app支持在前面修改基础上多次编辑，你应该允许用户撤回或者修改本次编辑。
framework中的类
PHAdjustmentData
当修改了一个asset后，Photos会将PHAdjustmentData对象和修改过的图片或者视频数据一起保存起来，你可以通过这个对象提供的一些数据来修改已经保存的编辑。
当需要调整data的时候，调用
-(PHContentEditingInputRequestID)requestContentEditingInputWithOptions:(PHContentEditingInputRequestOptions*)optionscompletionHandler:(void(^)(PHContentEditingInput *contentEditingInput, NSDictionary *info))completionHandler
初始化方法:
/** * 用于标记特定的修改数据，使用formatIndentifier和formatVersion指定唯一的adjustment， *data存储用于回滚到之前状态的数据,也就是当前图片的修改数据，以便于在这个基础上继续进行修改* * @param formatIndentifier 用于标记 adjustmentdata* @param formatVersion version number for adjustmentdata* @paramdata包含了重新修改需要的数据* */- (instanceType)initWithForamtIndentifier:(NSString*)formatIndentifier formatVersion:(NSString*)formatVersiondata:(NSData*)data;
PHAssetChangeRequest
在图库中使用PHAssetChangeRequest对象来创建，修改，删除PHAsset对象。
可以使用适当的类方法来实现增加删除修改asset的目的：
/**
* 删除给定的assets
*
* @param assets 包含需要删除的asset数组
*/+ (void)deleteAssets:(id)assets;/**
* 修改给定的PHAsset对象
*
* 在修改之前使用 'canPerformEditOperation:' 方法判断asset是否允许修改
* 在photo library change block中创建修改请求后，设置正确的修改请求属性。
*
* @param asset 待修改的asset
*/+ (instancetype)changeRequestForAsset:(PHAsset *)asset;
PHFetchOptions
当你使用没方法获取PHAsset（图片和视频）,PHCollection（相册类型）,PHAssetCollection（相册）的实体（相当于包含多个数据的模型）使用PHFetchOptions对象指定操作，例如获取的实体的排列属性等。
调用PHFetchRequest类方法创建一个包含fetch请求的对象。
这个类包含了两个属性：predicate和sortDescriptors。
NSPredicate *predicate：
specifies which properties to select results by and that also specifies any constraints on selection.
用于指定返回的结果和指定条件
示例：
PHFetchOperation *fetchOptions = [PHFetchOptionnew];fetchOperations.predicate = [NSPredicatepredicateWithFormat:@"(mediaSubtype & %d) != 0 || (mediaSubtype & %d) != 0", PHAssetMediaSubtypePhotoPanorama,PHAssetMediaSubtypeVideoHightFrameRate];PHFetchResult *result = [PHAssetfetchAssetWithOptions:fetchOptions];
NSArray *sortDescriptors
用于指定获取的对象的顺序
用一个例子实现以时间顺序倒序（刚拍摄的照片放在前头排列获取图片的功能：
PHFetchOption *option= [PHFetchOption new];option.sourtDescriptors = @[NSSortDescriptors sortDescriptiorWithKey:@"creationDate"ascending:NO];PHFetchResult *result = [PHAsset fetchAssetsWithOptions:option];
其他几个属性：
//用于确定app是否接收到了具体的改变信息。@property(nonatomic, assign) BOOL wantsIncrementalChangeDetails/**
*限制检索获取得到的photo实体的最小数量，当实体数量十分巨大时，作用显著，
*例如，用'PHAsset'的'fetchAssetsWithOptions:'方法获取最近拍摄的照片等。
*/@property(nonatomic, assign, readwrite) NSUInteger fetchLimit//检索结果是否包含连拍图片，如果是NO，只显示用户选取的那种图片，如果为YES，@property(nonatomic, assign) BOOL includeAllBurstAssets//顾名思义，是否检索隐藏的图片@property(nonatomic, assign) BOOL includeHiddenAssets/**
*包含的数据类型：
*PHAssetSourceTypeUserLibrary
*PHAssetSourceTypeCloudShared
*PHAssetSourceTypeiTunesSynced
*/@property(nonatomic, assign) PHAssetSourceType includeAssetSourceTypes
PHImageRequestOption
PHImageRequestOption 用于配置从PHImageManager中获取asset的请求。
常用的一些属性和方法有：
/**
* @discuss 如果是NO,表示为异步操作，从manager中请求图片时，
* 'reqeustImageForAssets:targetSize:options:resultHandler'方法会立即返回，
* 建议在后台只在后台线程中执行同步请求
*/@property(nonatomic,assign)BOOLsynchronous;/**
*typedef : NSInteger {
PHImageRequestOptionsDeliveryModeOpportunistic = 0,
PHImageRequestOptionsDeliveryModeHighQualityFormat = 1,
PHImageRequestOptionsDeliveryModeFastFormat = 2,
} PHImageRequestOptionsDeliveryMode;
*@PHImageRequestOptionsDeliveryModeOpportunistic:
自动返回一个或多个结果，来平衡图片的质量和响应性，它会多次调用
resutltHandler:'requestImageForAssets:targetSize:options:resultHandler'.
它首先会先调用一次'resutltHandler'返回清晰度低的图片作为临时显示图片，
等到能获取到高清晰度的图片时再次调用'resutltHandler'返回高质量图片。
note:如果'synchronous'是NO那么该属性无效
*@PHImageRequestOptionsDeliveryModeHighQualityFormat
只返回高分辨率的图片。具有较高的优先权
*@PHImageRequestOptionsDeliveryModeFastFormat
快速返回结果，可能会牺牲图片质量。
*/@property(nonatomic,assign) PHImageRequestOptionsDeliveryMode deliveryMode;/**
* a mode that specifies how to resize the reuqested image
*/@property(nonatomic,assign) PHImageRequestOptionsResizeMode resizeMode;
从iCloud中下载照片
/**
* 能否从iCloud中下载图片，
YES,本地也没有保存此图片，从iCloud上下载，用'progressHandler'这个block获取下载进度；
NO,同时本地也没有图片，'progressHander'中的info[PHImageReustIsInCloudKey]返回值会表示不能下载
*/@property(nonatomic,assign,getter=isNetworkAccessAllowed)BOOLnetworkAccessAllowed;/**
下载进度block，在多条线程中执行操作，刷新UI时需要回到主线程
*/typedefvoid(^ PHAssetImageProgressHandler)(doubleprogress,NSError*error,BOOL*stop,NSDictionary*info);@property(nonatomic,copy) PHAssetImageProgressHandler progressHandler
PHFetchResult
PHFetchRequest是有序的photo实体对象的容器，包含通过给定的检索条件返回的asset，相册，一个相册类型中的所有相册列表（例如，smart album类型下的所有相册，它是有序的），在PHAsset,PHCollection,PHAssetcollection,PHCollectionList这几个类中都包含有相应的类方法包含对应信息的PHFetchRequest对象,例如：
PHAsset
/***@param mediaType*aaset类型，包含有:*PHAssetMediaTypeUnknown = 0,*PHAssetMediaTypeImage,*PHAssetMediaTypeVideo,*PHAssetMediaTypeAudio,**@param options 检索操作**@return 带有符合条件的PHAsset对象集合的PHFetchRequest对象*/
+(PHFetchResult*)fetchAssetsWithMeidaType:(PHAssetMediaType)mediaType
options:(PHFetchOptions *)options
PHCollection (抽象类，不允许直接使用,开发过程中用它的两个子类PHCollectionList和PHAssetCollection替代)
//Retrieves collectionsfromthe rootofthe photo library’s hierarchyofuser-created albumsandfolders.+(PHFetchResult *)fetchTopLevelUserCollectionsWithOption:(PHFetchOptions *)options;
PHAssetCollection：
/*** 获取自定条件的相册** @paramtype相册类型：PHAssetCollectionTypeAlbumPHAssetCollectionTypeSmartAlbumPHAssetCollectionTypeMoment* @param subtype相对于相册类型更具体些的相片类型，如全景，照片流等* @param options 检索条件** @return 符合条件的相册*/+(PHFetchResult *)fetchAssetColletcionsWithType:(PHAssetCollectionType)typesubtype:(PHAssetCollectionSubtype)subtype options:(PHFetchOptions*)options;
PHCollectionList:
+(PHFetchResult *)fetchCollectionListsWithType:(PHCollectionListType)collectionListType subtype:(PHCollectionListSubtype)subtype options:(PHFetchOptions*)options
PHFetchRequest虽然包含了符合条件的photo实体的集合，与NSArray不同的是它会动态改变包含的内容，在处理大量的asset的时候效率更高些，实现的效果也好点
常用属性与方法
//是否包含给定的对象-(BOOL)containsObject:(ObjectType)anObject//包含的photo实体个数@property(readonly)NSUIntegercount//指定类型的asset数量-(NSUInteger)countOfAssetsWithMediaType:(PHAssetMediaType)mediaType
PHImageManager
PHImageManager有一个单例方法，同时也提供了用于获取全尺寸图片，图片缩略图等方法.
获取图片：
/**
* 会多次调用'resultHandler'，第一次调用，返回的图片清晰度较低，
* 当高清晰度图片可以获取时,会再次调用，如果高质量的图片在缓存汇中，只调用一次'resultHandler'。
* 这个方法默认是异步的，当从后台线程调用这个方法时，需要将options的'synchronous'设为YES.
*
* @param asset 保存图片信息的asset
* @param targetSize 返回的图片尺寸
* @param contentMode 返回的图片显示模式
* @param options image request option
* @param resultHandler 返回的内容
*
* @return 请求标示，用于取消请求*/-(PHImageRequestID)requestImageForAsset:(PHAsset*)assettargetSize:(CGSize)targetSizecontentMode:(PHImageContentMode)contentModeoptions:(PHImageRequestOptions*)optionsresultHandler:(void(^)(UIImage *result, NSDictionary *info))resultHandler;/**
* 请求全尺寸的图片，只执行一次'resultHandler'，
* 如果options的'version'被设置为'PHImageRequestOptionsVersionCurrent,'
* 返回在这个asset上发生的任何编辑后的imageData，如果不是的话，返回最原始版本的图片
*
* @param asset 保存图片信息的asset
* @param options image request option
* @param resultHandler 返回的内容
*
* @return 请求标示，用于取消请求
*/-(PHImageRequestID)requestImageDataForAsset:(PHAsset*)assetoptions:(PHImageRequestOptions*)optionsresultHandler:(void(^)(NSData *imageData, NSString *dataUTI, UIImageOrientation orientation, NSDictionary *info))resultHandler;
取消请求：
-(void)cancelImageRequest:(PHImageRequestID)requestID
PHCachingImageManager
PHCachingImageManager是PHImageManager的子类，如果相册中有大量的图片，而你的需求是要快速的获取这些图片的缩略图和大图数据用于展示，这个时候可以用PHCachingImageManager来实现，它具有缓存机制可以快速获取一个图册的缩略图，或者在后台请求全尺寸图片以便于快速展示。
开始缓存图片：
/** *@discuss当调用这个方法的时候，cacaingManager开始在获取你所需要的数据， * 同时在后台生成缩略图，之后可以使用'requestImagesFromAssets:targetSize:contentMode:resultHandler:' * 方法从缓存中请求数据。 * Photos会按照给定的尺寸，显示模式返回图片，缓存中的图片尺寸是固定的 * *@paramassets 需要缓存的assets *@paramtargetSize 图片尺寸 *@paramcontentMode 显示模式 *@paramoptions 请求操作 */- (void)startCachingImagesForAssets:(NSArray *)assetstargetSize:(CGSize)targetSizecontentMode:(PHImageContentMode)contentModeoptions:(PHImageRequestOptions *)options;
取消图片缓存：
/** * 当使用collectionView展示图片缩略图的时候，如果需要改变尺寸大小的时候， * 就需要将缓存中的旧图片删除重新缓存。 * *@paramassets 需要缓存的assets *@paramtargetSize 图片尺寸 *@paramcontentMode 显示模式 *@paramoptions 请求操作 */- (void)stopCachingImagesForAssets:(NSArray *)assetstargetSize:(CGSize)targetSizecontentMode:(PHImageContentMode)contentModeoptions:(PHImageRequestOptions *)options;
PHPhotoLibrary
PHPhotoLibrary可以看成是一个用户图库，包含了一些的图片和相册，同时包含本地的和iCloud中的资源。当Photos app发生图片的修改、增加、删除等改变时，使用PHPhotoLibrary来做一些刷新UI，保存数据等响应动作，同时也可以注册观察者（使用registerChangeObserver方法），当Photos app内容发生改变的时，会触发代理方法photoLibraryDidChange。
使用PHPhotoLibrary响应图库改变
Photos中的PHAsset,PHAssetCollection等是不可变对象，因此要改变当前这些类型对象的时候就需要使用photo library实现改变。
请求改变数据需要用到PHAssetChangeRequest,PHAssetcCollectionChangeRequest,PHCollectionListChangeRequest。
使用步骤：
1、创建实体
每个change request类都提供了用于创建响应的实体类的方法：
creationRequestForAssetCollectionWithTitle:创建了一个asset Collection
如果要添加一个新的asset到collection中，需要用到change request提供的PHObjectPlaceholder对象。在change block结束之后，使用placeholder对象提供的localIdentifier属性获取创建好的asset对象。
2、删除实体
例如：deleCollectionLists用于删除collection list
3、修改实体
changeRqeustForAsset创建了一个可用于修改的asset的change request
下面代码实现往相册中添加新图片的功能：
- (void)addNewAssetWithImge:(UIImage*)image toAlbum:(PHAssetCollection *)album { [[PHPhotoLibrarysharedPhotoLibrary]performChanges:^{ PHAssetChangeRequest *assetChange = [PHAssetChangeRequest creationRequestForAssetFromImage:image];PHAssetCollectionChangeRequest *collectionChange = [PHAssetCollectionChangeRequest changeRequestForAssetCollection:album];PHObjectPlaceholder *placeholder = [assetChange placeholderForCreatedAsset];[collectionChangeaddAssets:@[placeholder]];} completionHandler:^(BOOLsuccess, NSError * _Nullable error) { NSLog(@"Finished adding asset. %@", (success ? @"Success": error));}];}
note:For each call to the performChanges:completionHandler: or performChangesAndWait:error: method, iOS shows an alert asking the user for permission to edit the contents of the photo library.
注册观察者
PHPhotoLibraryChangeObserver在系统图库发生变化的时候就会通知指定的观察者，只要是使用了Photos framework实现的改变，都会触发观察者的方法。
registerChangeObserver:方法指定一名观察者，当系统图库发生改变，会触发观察者的指定方法，这个方法在PHPhotoLibraryChangeObserver协议中：- (void)photoLibraryDidChange:(PHChange *)changeInfo ;
PHCollection
PHCollection是一个抽象类，不允许直接使用它的实例对象，而是使用它的两个子类：PHAssetCollection,PHCollectionList：
PHAssetCollection 包含了带有图片或者视频信息PHAsst对象，PHCollectionList可以看做是一个文件夹，里面存放多个相册或者是在年度相册中的所有时刻的照片。
获取图片集合：
//用特定的操作从collection list中获取collection集合+ (PHFetchResult)fetchCollectionsInCollectionList:(PHCollectionList *)collectionListoptions:(PHFetchOptions *)options//获取所有用户创建的相册或者文件夹。+ (PHFetchResult *)fetchTopLevelUserCollectionWithOptions:(PHFetchOptions *)options;
PHAssetCollection
一个PHAssetCollection代表一个相册，可能包含图片和视频，例如：时间相册，我的照片流，自拍。
在Photos framework中不能直接获取collection中的内容，通过fetchAssetsInAssetCollecton:options:获取到包含PHAsset集合的PHFecthReult对象，之后用fetchResult提供的方法取出图片或者视频。
获取asset collection 的方法有许多种：
/** * @paramtype相册类型：PHAssetCollectionSubtypeAlbumRegularPhotosAPP中创建的相册PHAssetCollectionSubtypeAlbumSyncedEvent从iPhoto中同步的事件相册PHAssetCollectionSubtypeAlbumSyncedFaces从iPhoto中同步的包含人脸的相册PHAssetCollectionSubtypeAlbumSyncedAlbum从iPhoto同步的普通相册PHAssetCollectionSubtypeAlbumImported从其他设备导入的相册PHAssetCollectionSubtypeAlbumCloudShared分享到iCloud的照片流相册PHAssetCollectionSubtypeAlbumMyPhotoStream用户个人的iCloud照片流PHAssetCollectionSubtypeSmartAlbumGeneric没有特定类型的只能相册PHAssetCollectionSubtypeSmartAlbumPanoramas全景图片相册PHAssetCollectionSubtypeSmartAlbumVideos视频相册PHAssetCollectionSubtypeSmartAlbumFavorites个人收藏PHAssetCollectionSubtypeSmartAlbumTimelapses延时摄影相册PHAssetCollectionSubtypeSmartAlbumAllHidden隐藏的图片相册PHAssetCollectionSubtypeSmartAlbumRecentlyAdded最近添加的图片PHAssetCollectionSubtypeSmartAlbumBursts连拍相册PHAssetCollectionSubtypeSmartAlbumSlomoVideos慢动作视频相册PHAssetCollectionSubtypeSmartAlbumUserLibrary在本地存在的相册（不包含icloud中的相册）PHAssetCollectionSubtypeSmartAlbumSelfPortraits自拍PHAssetCollectionSubtypeSmartAlbumScreenshots截屏PHAssetCollectionSubtypeAny获取所有类型的相册 * @param options 筛选操作 * * @return 包含符合条件的相册的fetch result */+ (PHFetchResult *)fetchAssetCollectionsWithType:(PHAssetCollectionType)typesubtype:(PHAssetCollectionSubtype)subtype options:(nullablePHFetchOptions*)options;/** * 获取符合特定类型同时包含指定asset的相册集合 * * @param asset 给定的sset * @paramtype指定相册类型 * @param options 获取操作 * */+ (PHFetchResult *)fetchAssetCollectionsContainingAsset:(PHAsset*)asset withType:(PHAssetCollectionType)typeoptions:(PHFetchOptions*)options;
PHCollectionList
PHCollectionList包含了更高级别的asset集合，可嵌套PHAssetCollection
和自身类型，还支持多重嵌套,例如获取时刻相册和时刻相册中年度照片等。
获取collection list的几种方法：
+ (PHFetchResult)fetchCollectionListsContainingCollection:(PHCollection*)collection options:(PHFetchOptions*)options;+ (PHFetchResult *)fetchCollectionListsContainingCollection:(PHCollection*)collection options:(nullablePHFetchOptions*)options;+ (PHFetchResult *)fetchCollectionListsWithLocalIdentifiers:(NSArray *)identifiers options:(nullablePHFetchOptions*)options;+ (PHFetchResult *)fetchCollectionListsWithType:(PHCollectionListType)collectionListType subtype:(PHCollectionListSubtype)subtype options:(nullablePHFetchOptions*)options;+ (PHFetchResult *)fetchMomentListsWithSubtype:(PHCollectionListSubtype)momentListSubtype containingMoment:(PHAssetCollection*)moment options:(nullablePHFetchOptions*)options;+ (PHFetchResult *)fetchMomentListsWithSubtype:(PHCollectionListSubtype)momentListSubtype options:(nullablePHFetchOptions*)options;
PHAsset
PHAsset代表一个视频或者图片资源，当需要展示或者修改Photos app中的图片时需要先获取asset，asset是不可改变的并且只保存了所代表的视频或者图片的metadata。
获取PHAsset的几种方法：
//从asset collection中获取符合条件的asset集合+ (PHFetchResult *)fetchAssetsInAssetCollection:(PHAssetCollection *)assetCollectionoptions:(PHFetchOptions *)options/**
* 默认返回所有类型的asset，如果要给asset添加更多的类型限定，可以在options的filter predicate中设置。
* @param mediaType :
PHAssetMediaTypeUnknown
未知类型
PHAssetMediaTypeImage
静态图片
PHAssetMediaTypeVideo
视频
PHAssetMediaTypeAudio
音频
注： PHMediaSubtype:
PHAssetMediaSubtypeNone = 0,
// Photo subtypes
PHAssetMediaSubtypePhotoPanorama = (1UL << 0),
PHAssetMediaSubtypePhotoHDR = (1UL << 1),
PHAssetMediaSubtypePhotoScreenshot NS_AVAILABLE_IOS(9_0) = (1UL << 2),
PHAssetMediaSubtypePhotoLive NS_AVAILABLE_IOS(9_1) = (1UL << 3),
// Video subtypes
PHAssetMediaSubtypeVideoStreamed = (1UL << 16),
PHAssetMediaSubtypeVideoHighFrameRate = (1UL << 17),
PHAssetMediaSubtypeVideoTimelapse = (1UL << 18),
*/+ (PHFetchResult *_Nullable)fetchAssetsWithMediaType:(PHAssetMediaType)mediaTypeoptions:(PHFetchOptions *_Nullable)options;+ (PHFetchResult * *)fetchAssetsWithLocalIndentifiers:(NSArray )identifieroptions:(PHFetchOptions *)options;/**
* 获取key asset，每一个collection都至少有一个key asset，每个不同类型的collection用于定义key asset的方式也不同，有的collection中只有一个key asset，有的含有多个。
* 例如在相机胶卷中，最近拍摄的图片或者视频就是key asset
*/+ (PHFetchResult )fetchKeyAssetsInAssetCollection:(PHAssetCollection *)collectionoptions:(PHFetchOptions *)options;/**
* 获取所有的符合条件的asset，默认条件下，不包含通过iTunes同步过来的和存储在iCloud中的图片。
* 更改此条件，配置options的'includeAssetSourceType'属性来实现。
*/+ (PHFetchResult *)fetchAssetsWithOptions:(PHFetchOptions *)options;//获取连拍照片+ (PHFetchResult )fetchAssetWithBurstIdentifier(NSString *)burstIdentifieroptions:(PHFetchOptions *)options;
