PhotoKit

戴铭 edited this page Apr 23, 2015 · 2 revisions

简介

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属性。

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.