PhotoKit是一套比AssetsLibrary更完整也更高效的库,而其处理方式也跟AssetsLibrary有很大的不同。该框架不仅支持照片的编辑
,还提供了直接访问
照片管理应用程序里的照片和视频资源,包括iCloud照片库。我们可以使用这个框架来检索相册资源显示和播放,且编辑他们的图像或视频内容。
PhotoKit组成
从官方文档可以看出,其成员比较多,下面只介绍几个比较常用的:
- PHAsseet:代表照片库中的一个资源,跟 ALAsset 类似,通过 PHAsset 可以获取和保存资源;
- PHFetchOptions:获取资源时的参数,可以传nil,即使用系统默认值;
- PHFetchResult:表示一系列的资源集合,也可以是相册的集合;
- PHAssetCollection:表示一个相册或者一个时刻,或者是一个「智能相册(系统提供的特定的一系列相册,例如:最近删除,视频列表,收藏等等);
- PHCollectionList:表示一组PHCollection,而它本身也是一个PHCollection,因此PHCollection作为一个集合,可以包含其他集合;
- PHImageManager:用于处理资源的加载,加载图片的过程带有缓存处理,可以通过传入一个 PHImageRequestOptions 控制资源的输出尺寸等规格;
- PHImageRequestOptions:如上面所说,控制加载图片时的一系列参数。
还有PHChange
、
PHAssetChangeRequest
、PHContentEditingInput
、PHContentEditingOutput
等进行照片资源内容编辑操作的类和其他的一些类。
PhotoKit的使用
访问相册资源
以下是官方demo的代码片段:
PHFetchOptions *allPhotosOptions = [[PHFetchOptions alloc] init];
allPhotosOptions.sortDescriptors = @[[NSSortDescriptor sortDescriptorWithKey:@"creationDate" ascending:YES]];
PHFetchResult *allPhotos = [PHAsset fetchAssetsWithOptions:allPhotosOptions];
PHFetchResult *smartAlbums = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeSmartAlbum
subtype:PHAssetCollectionSubtypeAlbumRegular options:nil];
PHFetchResult *topLevelUserCollections = [PHCollectionList fetchTopLevelUserCollectionsWithOptions:nil];
对上面这段代码进行分析:首先创建一个PHFetchOptions对象,然后设立其根据创建时间排序的option,使用fetchAssetsWithOptions:
方法获取所有的相片资源;而使用fetchAssetCollectionsWithType:
方法根据特定的type获取指定类型的相册;使用fetchTopLevelUserCollectionsWithOptions:
方法可以获取所有用户创建的相册。
以上是获取资源,下面来分析怎样获取可供直接展示的资源:
// Request an image for the asset from the PHCachingImageManager.
[self.imageManager requestImageForAsset:asset
targetSize:AssetGridThumbnailSize
contentMode:PHImageContentModeAspectFill
options:nil
resultHandler:^(UIImage *result, NSDictionary *info) {
// Set the cell's thumbnail image if it's still showing the same asset.
if ([cell.representedAssetIdentifier isEqualToString:asset.localIdentifier]){
cell.thumbnailImage = result;
}
}];
imageManager是一个PHCachingImageManager对象,使用requestImageForAsset:targetSize:contentMode:options:resultHandler:
方法最后返回的result即为需要的image;而PHCachingImageManager这个类还有另外一个方法:startCachingImagesForAssets:targetSize:contentMode:options:
给指定相片资源做缓存。如果是视频资源则可以如下获取:
// Request an AVAsset for the PHAsset we're displaying.
[[PHImageManager defaultManager] requestAVAssetForVideo:self.asset options:nil resultHandler:^(AVAsset *avAsset, AVAudioMix *audioMix, NSDictionary *info) {
CALayer *viewLayer = self.view.layer;
// Create an AVPlayerItem for the AVAsset.
AVPlayerItem *playerItem = [AVPlayerItem playerItemWithAsset:avAsset];
playerItem.audioMix = audioMix;
// Create an AVPlayer with the AVPlayerItem.
AVPlayer *player = [AVPlayer playerWithPlayerItem:playerItem];
// Create an AVPlayerLayer with the AVPlayer.
AVPlayerLayer *playerLayer = [AVPlayerLayer playerLayerWithPlayer:player];
// Configure the AVPlayerLayer and add it to the view.playerLayer.videoGravity =AVLayerVideoGravityResizeAspect;
playerLayer.frame = CGRectMake(0, 0, viewLayer.bounds.size.width, viewLayer.bounds.size.height);
[viewLayer addSublayer:playerLayer];
[player play];
});
}];
avAsset就是返回的视频资源。
相册的添加、删除、编辑以及处理变更
在做这些操作之前需要添加PHPhotoLibraryChangeObserver
协议,然后注册PHPhotoLibrary的观察者:
[[PHPhotoLibrary sharedPhotoLibrary] registerChangeObserver:self];
至于具体的操作,官方文档有关于添加
、删除
、编辑
相册的例子:Requesting Changes to the Photo Library。之后,实现PHPhotoLibraryChangeObserver的协议方法:photoLibraryDidChange:
就OK了,而关于处理变更
也有例子:Handling Changes:An Example,。当然,最后记得在dealloc方法里注销这个协议:
[[PHPhotoLibrary sharedPhotoLibrary] unregisterChangeObserver:self];
Asset照片或视频资源的删除、编辑
其中一些固有的操作,可直接使用removeAssets:
、deleteAssets:
等方法来实现:
[[PHPhotoLibrary sharedPhotoLibrary] performChanges:^{
[PHAssetChangeRequest deleteAssets:@[self.asset]];
} completionHandler:completionHandler];
而其他的一些编辑处理,比如自定义操作。使用PHAssetChangeRequest的contentEditingOutput
的属性对象,这就需要我们创建一个PHContentEditingOutput
对象,然后进行相应的编辑处理。其中可能用到PHAdjustmentData这个类对操作进行标记描述。而这些都是写在requestContentEditingInputWithOptions:completionHandler:
这个方法里的。最后实现PHPhotoLibrary的performChanges:completionHandler:
方法。
扩展
参考链接及扩展阅读:照片框架、官方demo、PhotoKit详解(上)、PhotoKit详解(下)、PhotoKit实践及坑点、NSHipster/PHImageManager
可以观看WWDC session --- Introducing the Photos Frameworks 视频学习更多内容,发掘更深的知识,然后自己写一些demo。
Github上有个不错的照片浏览第三框架:MWPhotoBrowser