PhotoKit - ZhiJianShuSheng/Read-And-Learn GitHub Wiki
简介
PhotoKit比AssetsLibrary的特性更多表现更好。可以观察照片库的变化和创建提交自己修改的改变。官方代码示例https://developer.apple.com/library/ios/samplecode/UsingPhotosFramework/Introduction/Intro.html#//apple_ref/doc/uid/TP40014575 ,WWDC session视频
PhotoKit对象模型
所有PhotoKit对象都继承PHObject抽象类,公共接口只提供localIdentifier属性。
- PHAsset:表示照片库里单独资源以提供资源元数据。
- PHAssetCollection:表示资源集合,是PHCollection的子类。单独的资源集合可以是照片库里的相册或智能相册,包括所有的视频集合,最近添加项目,用户收藏,所有连拍照片等。
- PHCollectionList:表示一组PHCollections。在照片应用可以看到它,照片 - 时刻 - 精选 - 年度
Fetch照片实体
Fetch方法命名类似class func fetchXXX(..., options: PHFetchOptions) -> PHFetchResult。这里的options参数提供了对结果进行过滤和排序的途径,和NSFetchRequest的predicate与sortDescriptors类似。
获取结果为返回的PHFetchResult对象,能够缓存最近请求内容,这个返回不会自动更新。如果要更新实时显示最新结果需要通过PHPhotoLibrary对象用registerChangeObserver(...)方法注册一个遵从PHPhotoLibraryChangeObserver协议的Observer。如果照片库里有变化了,photoLibraryDidChange(...)方法会被调用,这个方法只有一个PHChange类型参数。
PHChange提供了changeDetailsForObject(…)和changDetailsForFetchResult(...)方法能够通过传入需要观察跟踪的PHObject或PHFetchResult对象来跟踪变化。观察变化用PHObjectChangeDetails观察是否变化是否曾被删除或PHFetchResultChangeDetails适合简化CollectionView或TableView更新操作。
Transient Collections临时集合
通过PHAsset对象数组或PHFetchResult对象来创建临时资源合集。创建的这些操作在PHAssetCollection的transientAssetCollectionWithAssets(…)和transientAssetCollectionWithFetchResult(...)工厂方法内完成。创建出来的的对象跟PHAssetCollection对象一样使用。
可以用PHCollectionList中的transientCollectionListWithXXX(...)工厂方法来创建临时集合列表。
照片元数据
PhotoKit提供关于用户资源的元数据。
HDR和全景照片
用照片资源的mediaSubtypes属性验证资源库里图像是否开启了HDR,拍摄是否使用了相机全景模式。
收藏和隐藏资源
验证资源是否被用户收藏或隐藏,检查PHAsset实例的favorite和hidden属性。
连拍模式照片
如果一个资源的PHAsset的representsBurst属性为true就表示资源是连拍。它还有个属性burstIdentifier,想要获得连拍其余照片可以通过这个值传入fetchAssetsWithBurstIdentifier(...)方法获取。通过PHAsset的burstSelectionTypes属性访问标记用户可能会选择的潜在代表照片。
burstSelectionTypes这个属性的三个常量组成的位掩码
- .UserPick:表示用户手动标记的资源
- .AutoPick:表示用户可能标记的潜在资源
- .None:表示没有标记的资源
PHImageManager照片加载管理编辑
PHImageManager可以处理图像大小修改裁剪和缓存等。
请求图像
通过requestImageForAsset(…)请求,可以通过PHImageRequestOptions参数设置返回图像大小和图像的其它选项,以及result handler。
图像的尺寸和裁剪
requestImageForAsset(…)方法的targetSize和contentMode俩参数决定照片是按比例缩放还是比例填充方式放到目标大小内。如果不裁剪不改大小,参数分别为PHImageManagerMaximumSIze和PHImageContentMode.Default。
PHImageRequestOptions的resizeMode属性可以设置为.Exact(和目标大小匹配).Fast(效率高但可能和目标大小不一样)或.None。normalizedCroppingMode属性确定如何裁剪图像,如果这只了这个值,那么resizeMode必须为.Exact。
将图片递送给你
默认情况图像管理器会先传递一个较低质量版本的图像给你,然后再将图像的高质量版本递送给你。可以通过 deliverMode属性控制这个行为,默认行为的值为.Opportunistic。设置.HighQualityFormat如果只要高质量图像也要接受更长的加载时间。.FastFormat就可以得到更快加载速度,但会牺牲图片质量。
如果设置PHImageRequestOptions的synchronous属性为true同步操作,那么就都会deliverMode就都会按照.HighQualityFormat处理,这时要注意iCould照片库是要从网络上读取的,同步必定会带来慢,所以可以将networkAccessAllowed设置为false
当然也可以使用和iCloud相关的属性progressHandler。可以将它设置为PHAssetImageProgressHandler的block,从iCloud下载照片时就会被图像管理器自动调用。
照片资源的版本
通过设置version属性
- .Current:修改和调整过的图像
- .Unadjusted:递送未被修改的图像,递送JPEG
- .Original:递送原始质量最高格式的图像
Result handler
包含一个UIImage和一个info字典,根据字典信息可以实时更新UI告知用户当前状态。
info字典提供请求状态信息
- PHImageResultIsInCloudKey:图像是否必须从iCloud请求
- PHImageResultIsDegradedKey:当前UIImage是否是低质量的,这个可以实现给用户先显示一个预览图
- PHImageResultRequestIDKey和PHImageCancelledKey:请求ID以及请求是否已经被取消
- PHImageErrorKey:如果没有图像,字典内的错误信息
加载时的缓存
PHImageManager的子类PHImageCachingManager可以预先将一些图像加载到内存中来实现缓存。
- startCachingImagesForAssets(…):这个方法比较关键,需要传入一个PHAssets类型数组和一些请求参数。
- allowCachingHightQualityImages:这个属性为true适合比较短或者不变资源列表,如果是需要快速滑动操作的列表最好设置为false。
改变照片库
通过performChanges(…)提交到共享的PHPhotoLibrary的block内完成。
通过创建PHAssetChangeRequest可以修改资源创建日期,资源位置,是否隐藏资源,是否收藏,从照片库删除等。
通过PHAssetCollectionChangeRequest或PHCollectionListChangeRequest对象可以修改集合标题,添加删除集合成员,完全删除集合
通过creationRequestForAssetFromXXX(…)传入资源数据,可以创建一个新资源。对新资源有额外修改需求可以用placeholderForCreatedAsset属性。