Photos框架使用(一)

2018-02-07  本文已影响0人  CoderP1

前言

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

Photos的基本构成的介绍

Photos的使用

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

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

//获取相册
- (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 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的使用以及使用过程中遇到的一些问题.

上一篇 下一篇

猜你喜欢

热点阅读