Photo

# 简介 PhotoKit比AssetsLibrary的特性更多表现更好。可以观察照片库的变化和创建提交自己修改的改变。官方代码示例[https://developer.apple.com/library/ios/samplecode/UsingPhotosFramework/Introduction/Intro.html#//apple_ref/doc/uid/TP40014575](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属性。