Photos框架使用(一)

前言

iOS8之后,苹果推出新的管理图库资源框架Photos,相比于之前的ALAssetsLibrary框架来说,新框架更强大,功能更多,使得我们处理相册的选择性更多.下面,简单介绍一下,新框架的使用.

Photos的基本构成的介绍

• 和图库交互: 通过一个共享的图库对象,在用户授权的前提下可以获取图库资源,修改资源或者资源集合,监测图库资源的更新.

  • PHPhotoLibrary: 一个可以用来获取或者改变用户的图库的共享对象.

• 获取和检查资源: 下面这些类代表着图库中的内容: 资源和集合,这些对象的实例都是只读的,只包含元数据.通过这些资源和集合,你可以抓取到特定条件的对象集合.

  • PHAsset: 代表着图库里的一个图片,视频,Live Photo等
  • PHAssetCollection: photos资源的集合,例如一个时刻,用户创建的相册,或者是智能相册
  • PHCollectionList: PHAssetCollection的集合,例如一年的时刻集合,或者包含用户创建的相册的文件夹.
  • PHObject: Photos模型对象的抽象类(资源和集合).
  • PHFetchResult: Photos抓取方法返回的资源或集合的有序列表
  • PHFetchOptions: 一些选项的集合,它影响过滤,排序和你抓取资源或集合时对返回结果的管理.

• 加载资源内容:使用这些类来请求和资源相关联的图片,Live Photo内容.Photos会自动下载或生成你指定的图片,缓存以便快速重用.你也可以请求预加载批量的图片以便处理加载大量图片资源的情况.

  • PHImageManager: 提供方法来获取或者生成与assets相关联的预览缩率图或者全尺寸图片.

  • PHCachingImageManager: 相对于PHImageManager,它会针对加载大量assets资源时做出优化.

  • PHImageRequestOptions: 一些选项的集合,它能影响你从assets获取静态图片资源

  • PHVideoRequestOptions: 一些选项的集合,它能影响你从assets获取Live Photo资源

  • PHLivePhoto: Live Photo的一个可以播放的展现形式 - 一个包含拍照前后时刻声音和动作的图片

• 请求改变: 为了修改assets或者collections, 你创建请求对象来描述你的编辑并且明确地把它提交给图库.这个结构使编辑变得简单,安全,并且在多线程或者多个APP,APP扩展之间编辑同样的assets更高效.

  • PHAssetChangeRequest: 一个请求,用于创建,删除,改变源数据,或者编辑一个photo asset的内容,在图库修改block中使用.
  • PHAssetCollectionChangeRequest: 一个请求,用于创建,删除,改变源数据,或者编辑一个Photo collection的内容,在图库修改block中使用.
  • PHCollectionListChangeRequest: 一个请求,用于创建,删除,改变源数据,或者编辑一个Photo collection list的内容,在图库修改block中使用.
  • PHObjectPlaceholder: 一个只读的代理,表示一个已经被创建用于change request的asset或者集合对象

• 监听改变: 无论是别的app,别的设备,或者你APP中的代码改变了asset或者集合中一系列asset的元数据,photos都会告诉你的app.

  • PHPhotoLibraryChangeObserver: 你可以实现这个协议,当图库发生了变化时,你会被通知.
  • PHChange: 描述了图库发生的改变
  • PHObjectChangeDetails: 描述了一个asset或者集合对象发生的改变
  • PHFetchResultChangeDetails: 描述了在一个获取结果中列举的一系列asset或者集合对象的改变.

• 操作asset资源: 一个或者多个asset resource对象代表着每个asset表面下储存的数据.使用这些对象来直接操作那些资源 - 例如, 备份或者保存asset

  • PHAssetResource: 关联着图库中一个图片,视频或者Live Photo的数据资源.
  • PHAssetCreationRequest: 一个请求,基于表面下的数据资源,来创建一个新的asset,在图库修改block中使用.
  • PHAssetResourceCreationOptions: 一个选项的集合,这些选项影响着从隐藏资源创建一个新的asset.
  • PHAssetResourceManager:提供方法来获取与asset相关联的数据资源.
  • PHAssetResourceRequestOptions: 一个选项的集合,这些选项影响着你通过asset resource manager获取数据的传输.

Photos的使用

下面我们来看看Photos的使用,通过下面的代码,我们可以了解怎么使用这个框架,以及使用过程中的一些注意事项.

• 使用photos来获取图库中的相册.
  首先我们创建一个项目,然后这里我们遍历获取图库的相册,并把相册展示在界面.

  
  Simulator Screen Shot - iPhone 8 Plus - 2018-03-22 at 14.55.54.png

效果如上图,这里我们获取相册数据,并展示它的名称信息.我封装了一个工具类用于执行获取相册,图片资源等操作.
主要的代码如下

//获取相册
- (void)requestCollectionWithHandler:(completion)handler {
    __block completion operation = handler;
    if ([self checkAuthorization]) {//授权成功
        __block NSMutableArray *arr1 = [NSMutableArray new];
        PHFetchResult *result1 = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum subtype:PHAssetCollectionSubtypeSmartAlbumTimelapses options:nil];
        [result1 enumerateObjectsUsingBlock:^(id  _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
            if ([obj isKindOfClass:[PHAssetCollection class]]) {
                [arr1 addObject:(PHAssetCollection *)obj];
            }
        }];
        
         __block NSMutableArray *arr2 = [NSMutableArray new];
        PHFetchResult *result2 = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeSmartAlbum subtype:PHAssetCollectionSubtypeAny options:nil];
        
        [result2 enumerateObjectsUsingBlock:^(id  _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
            if ([obj isKindOfClass:[PHAssetCollection class]]) {
                [arr2 addObject:(PHAssetCollection *)obj];
            }
        }];
        [arr1 addObjectsFromArray:arr2];
        if (operation) {
            dispatch_async(dispatch_get_main_queue(), ^{
                operation(YES, arr1);
            });
        }
        
    }else {//授权失败
        [PHPhotoLibrary requestAuthorization:^(PHAuthorizationStatus status) {
            if (status == PHAuthorizationStatusAuthorized) {
                [self requestCollectionWithHandler:operation];
            }
        }];
    }
    
}

注意:
IDE环境:Xcode 9.2, 模拟器是iOS11.2的 iPhone8 plus, 由于iOS10对用户隐私更加看重,所以infoplist必须添加"Privacy - Photo Library Usage Description"这个key,并且描述你的app想要使用图库的意图.而且我们在获取图库资源之前应该先判断用户授权的状态,如果用户未授权是不能获取到数据的.

让我们看一下上面使用到的一些参数,首先,你获取相册的时候,需要指定相册的类型和子类型,关于相册的类型,请看下面的标注

typedef NS_ENUM(NSInteger, PHAssetCollectionType) {
    PHAssetCollectionTypeAlbum      = 1, //从 iTunes 同步来的相册，以及用户在Photos中自己创建的相册
    PHAssetCollectionTypeSmartAlbum = 2, //经由相机得来的相册
    PHAssetCollectionTypeMoment     = 3, //Photos 为我们自动生成的时间分组的相册
} PHOTOS_ENUM_AVAILABLE_IOS_TVOS(8_0, 10_0);

typedef NS_ENUM(NSInteger, PHAssetCollectionSubtype) {
    
    // PHAssetCollectionTypeAlbum regular subtypes
    PHAssetCollectionSubtypeAlbumRegular         = 2, //用户在 Photos 中创建的相册
    PHAssetCollectionSubtypeAlbumSyncedEvent     = 3, /使用 iTunes 从 Photos 照片库或者 iPhoto 照片库同步过来的事件。
    PHAssetCollectionSubtypeAlbumSyncedFaces     = 4, //使用 iTunes 从 Photos 照片库或者 iPhoto 照片库同步的人物相册。
    PHAssetCollectionSubtypeAlbumSyncedAlbum     = 5, //做了 AlbumSyncedEvent 应该做的事
    PHAssetCollectionSubtypeAlbumImported        = 6, //从相机或是外部存储导入的相册
    
    // PHAssetCollectionTypeAlbum shared subtypes
    PHAssetCollectionSubtypeAlbumMyPhotoStream   = 100, //用户的 iCloud 照片流
    PHAssetCollectionSubtypeAlbumCloudShared     = 101, //用户使用 iCloud 共享的相册
    
    // PHAssetCollectionTypeSmartAlbum subtypes
    PHAssetCollectionSubtypeSmartAlbumGeneric    = 200, //文档解释为非特殊类型的相册，主要包括从 iPhoto 同步过来的相册
    PHAssetCollectionSubtypeSmartAlbumPanoramas  = 201, //相机拍摄的全景照片
    PHAssetCollectionSubtypeSmartAlbumVideos     = 202, //相机拍摄的视频
    PHAssetCollectionSubtypeSmartAlbumFavorites  = 203, //收藏文件夹
    PHAssetCollectionSubtypeSmartAlbumTimelapses = 204, //延时视频文件夹，同时也会出现在视频文件夹中
    PHAssetCollectionSubtypeSmartAlbumAllHidden  = 205, //包含隐藏照片或视频的文件夹
    PHAssetCollectionSubtypeSmartAlbumRecentlyAdded = 206, //相机近期拍摄的照片或视频
    PHAssetCollectionSubtypeSmartAlbumBursts     = 207, //连拍模式拍摄的照片
    PHAssetCollectionSubtypeSmartAlbumSlomoVideos = 208, //Slomo 是 slow motion 的缩写，高速摄影慢动作解析，在该模式下，iOS 设备以120帧拍摄。
    PHAssetCollectionSubtypeSmartAlbumUserLibrary = 209, //这个命名最神奇了，就是相机相册，所有相机拍摄的照片或视频都会出现在该相册中，而且使用其他应用保存的照片也会出现在这里。
    PHAssetCollectionSubtypeSmartAlbumSelfPortraits PHOTOS_AVAILABLE_IOS_TVOS(9_0, 10_0) = 210, //这个相册包含了用户使用前置摄像头拍摄的照片和视频
    PHAssetCollectionSubtypeSmartAlbumScreenshots PHOTOS_AVAILABLE_IOS_TVOS(9_0, 10_0) = 211, //使用设备的截屏功能生成的照片
    PHAssetCollectionSubtypeSmartAlbumDepthEffect PHOTOS_AVAILABLE_IOS_TVOS(10_2, 10_1) = 212, //在可兼容的设备上使用景深摄像模式拍的照片
    PHAssetCollectionSubtypeSmartAlbumLivePhotos PHOTOS_AVAILABLE_IOS_TVOS(10_3, 10_2) = 213, //包含所有的Live Photo资源
    PHAssetCollectionSubtypeSmartAlbumAnimated PHOTOS_AVAILABLE_IOS_TVOS(11_0, 11_0) = 214, //动图
    PHAssetCollectionSubtypeSmartAlbumLongExposures PHOTOS_AVAILABLE_IOS_TVOS(11_0, 11_0) = 215, //长曝光
    // Used for fetching, if you don't care about the exact subtype
    PHAssetCollectionSubtypeAny = NSIntegerMax ////包含所有类型
} PHOTOS_ENUM_AVAILABLE_IOS_TVOS(8_0, 10_0);

注意，获取指定类型的相册时，主类型和子类型要匹配，不要串台。如果不匹配，系统会按照 Any 子类型来处理。对于 Moment 类型，子类型使用 Any。

1.获取用户自己建立的相册和文件夹（我称之为逻辑相册，非系统相册和从 iTunes 同步来的相册）有两种方法:

  [PHCollection fetchTopLevelUserCollectionsWithOptions:nil];
  [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeAlbum subtype:PHAssetCollectionSubtypeAlbumRegular options:nil];

在没有提供PHOptions的情况下，返回的PHFetchResult结果是按相册的建立时间排序的，最新的在前面。
2.获取相机相册：

[PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeSmartAlbum subtype:PHAssetCollectionSubtypeSmartAlbumUserLibrary options:nil];

• 请求图像
  使用PHImageManager这个类来获取资源,你应该使用它的单例对象,而不是重新初始化一个实例对象.

  [[PHImageManager defaultManager] requestImageForAsset: targetSize: contentMode: options: resultHandler:];

这个方法默认是异步执行的,resultHandler可能会被多次调用,因为对于指定的尺寸,Photos可能会先提供低质量的图像以供临时显示,随后加载完指定尺寸的图像后再返回符合要求的图片.如果指定尺寸的高质量图片有缓存,那么就直接返回缓存,这些都可以通过options参数来指定.

俗话说得好,实践出真知,我们下面通过代码和模拟器来看一看这个图片请求过程.
在上面生成的相册中,我点击一个相册,进入一个新的控制器,在这个控制器里,我要展示相册里包含的PHAsset的缩率图,
请求图片的代码如下:

- (void)requestImgaeWithSize:(CGSize)size andAsset:(PHAsset *)asset andCompletionHandler:(void (^)(UIImage *))handler {
    __block void (^ operation)(UIImage *) = handler;
    PHImageRequestOptions *options = [PHImageRequestOptions new];
    options.synchronous = YES;
    options.resizeMode = PHImageRequestOptionsResizeModeExact;
    options.deliveryMode = PHImageRequestOptionsDeliveryModeFastFormat;
    options.normalizedCropRect = CGRectMake(0.25, 0.25, 0.5, 0.5);
    [[PHCachingImageManager defaultManager] requestImageForAsset:asset targetSize:size contentMode:PHImageContentModeAspectFill options:options resultHandler:^(UIImage * _Nullable result, NSDictionary * _Nullable info) {
        dispatch_async(dispatch_get_main_queue(), ^{
            if (operation) {
                operation(result);
                operation = nil;
            }
        });
    }];
}

然后我点击了Camera Roll这个相册,进去之后展示了这个相册里的图片;如下图:

Simulator Screen Shot - iPhone 8 Plus - 2018-03-22 at 16.12.21.png

我们接下来 做一个操作,点击某个item进入到详细的图片展示界面.然后我们把图片写入到本地桌面上,来分析请求图片传入的参数有啥影响.

我们点击海绵宝宝这张图片进入具体的图片展示界面,这里我们做了一个操作,把这个获取到的图片写到桌面了,

 [[PhotosTool sharedTool] requestImgaeWithSize:CGSizeMake(_asset.pixelWidth, _asset.pixelWidth) andCropRect:CGRectMake(0, 0, 1, 1) andAsset:_asset andCompletionHandler:^(UIImage *result) {
        _poster.image = result;
        //把图片写入本地桌面
        NSData *data = UIImagePNGRepresentation(result);
        [data writeToFile:@"/Users/rjkfb2/Desktop/test.png" atomically:YES];
    }];

然后,我们来看一下这个写入到桌面的图片的尺寸大小

屏幕快照 2018-03-22 下午4.29.09.png

2048*2048,像素为单位,这里原图就是这个尺寸.
下面我们要仔细说下一PHImageRequestOptions这个类的作用.首先我们看一下这个类的实例对象有哪些属性

@property (nonatomic, assign) PHImageRequestOptionsVersion version; // version
@property (nonatomic, assign) PHImageRequestOptionsDeliveryMode deliveryMode; // delivery mode. Defaults to PHImageRequestOptionsDeliveryModeOpportunistic
@property (nonatomic, assign) PHImageRequestOptionsResizeMode resizeMode; // resize mode. Does not apply when size is PHImageManagerMaximumSize. Defaults to PHImageRequestOptionsResizeModeNone (or no resize)
@property (nonatomic, assign) CGRect normalizedCropRect; // specify crop rectangle in unit coordinates of the original image, such as a face. Defaults to CGRectZero (not applicable)
@property (nonatomic, assign, getter=isNetworkAccessAllowed) BOOL networkAccessAllowed; // if necessary will download the image from iCloud (client can monitor or cancel using progressHandler). Defaults to NO (see start/stopCachingImagesForAssets)
@property (nonatomic, assign, getter=isSynchronous) BOOL synchronous; // return only a single result, blocking until available (or failure). Defaults to NO
@property (nonatomic, copy, nullable) PHAssetImageProgressHandler progressHandler; // provide caller a way to be told how much progress has been made prior to delivering the data when it comes from iCloud. Defaults to nil, shall be set by caller

version: 设置版本
deliveryMode: 请求的图像质量.有三种选择: 1.PHImageRequestOptionsDeliveryModeOpportunistic:  在速度和质量中均衡,当调用方式为异步的,客户端可能会获得一些图片,(类似于先返回模糊图片,然后再返回清晰的图片), 如果调用时同步的,那么只会返回一个图片; 2.PHImageRequestOptionsDeliveryModeHighQualityFormat:不管花费多长时间，提供高质量图像; 3.PHImageRequestOptionsDeliveryModeFastFormat: 以最快的速度返回一个图片,这个图片可能会降低质量. 这个属性只有在 synchronous 为 true 时有效。

resizeMode：对请求的图像怎样缩放。有三种选择：None，不缩放；Fast，尽快地提供接近或稍微大于要求的尺寸；Exact，精准提供要求的尺寸。

normalizedCropRect：用于对原始尺寸的图像进行裁剪，基于比例坐标。只在 resizeMode 为 Exact 时有效。

基于上面那个获取图片的例子,我们来验证一下resizeMode 对于返回的图片的影响,如果上面那个请求图片的代码,我们修改一下,把resizeMode,改为

- (void)requestImgaeWithSize:(CGSize)size andCropRect:(CGRect)rect andAsset:(PHAsset *)asset andCompletionHandler:(void (^)(UIImage *))handler {
    __block void (^ operation)(UIImage *) = handler;
    PHImageRequestOptions *options = [PHImageRequestOptions new];
    options.synchronous = YES;
    options.resizeMode = PHImageRequestOptionsResizeModeFast;
    options.deliveryMode = PHImageRequestOptionsDeliveryModeFastFormat;
    [[PHCachingImageManager defaultManager] requestImageForAsset:asset targetSize:size contentMode:PHImageContentModeAspectFit options:options resultHandler:^(UIImage * _Nullable result, NSDictionary * _Nullable info) {
        dispatch_async(dispatch_get_main_queue(), ^{
            if (operation) {
                operation(result);
                operation = nil;
            }
        });
    }];
}

这里再看看返回的图片大小

屏幕快照 2018-03-22 下午4.40.05.png

这时候就不是你指定的尺寸了.由此可以体会到resizeMode参数的作用,resizeMode为fast的时候会以最快速度返回一个大小和指定尺寸相近的图片,但是可能大小不一样.

接下来,我们来看看photos一个很实用的功能,就是通过指定normalizedCropRect这个参数,来返回裁剪好的图片,这个参数是基于比例坐标,类似于layer的锚点这个属性,X,Y轴最大值都是1,
代码如下:

- (void)requestImgaeWithSize:(CGSize)size andAsset:(PHAsset *)asset andCompletionHandler:(void (^)(UIImage *))handler {
    __block void (^ operation)(UIImage *) = handler;
    
    PHImageRequestOptions *options = [PHImageRequestOptions new];
    options.synchronous = YES;
    options.resizeMode = PHImageRequestOptionsResizeModeExact;
    options.deliveryMode = PHImageRequestOptionsDeliveryModeFastFormat;
    options.normalizedCropRect = CGRectMake(0, 0, 0.5, 0.5);
    [[PHCachingImageManager defaultManager] requestImageForAsset:asset targetSize:size contentMode:PHImageContentModeAspectFit options:options resultHandler:^(UIImage * _Nullable result, NSDictionary * _Nullable info) {
        if (operation) {
            operation(result);
            operation = nil;
        }
    }];
}

让我们来看一下返回的图片

屏幕快照 2018-03-23 上午10.11.14.png
屏幕快照 2018-03-23 上午10.11.21.png

这时候可以看到返回的图片就是原图片的左上角,然后像素是你给定的100* 100.
demo下载地址
好啦,以上就是PhotosKit的简单使用,第二篇文章也是有关Photoskit的使用以及使用过程中遇到的一些问题.