iOS 基于PhotoKit框架的自定义相册

今天给大家讲一个干货，简单实用。之前公司的项目需要自定义相册，并且需要获取图片的经纬度信息，使用UIImagePickerController自然是实现不了的。所以就用到了我们今天所说的PhotoKit框架，因为PhotoKit是iOS8之后出的，所以iOS8以前的项目是不能使用的（可以使用AssetsLibrary，这里就不多介绍了）。

LYFAlbum.gif

先来介绍一下PhotoKit的主要属性：

1.PHPhotoLibrary

官方解释：PHPhotoLibrary提供对用户照片库中的照片、视频和相关内容的元数据和图像数据的访问，包括来自照相机辊、iCloud共享、照片流、从iTunes导入和同步的内容。
简单的说就是提供了，获取用户是否已经开通访问相册的权限。

[PHPhotoLibrary requestAuthorization:^(PHAuthorizationStatus status) {
    if (status == PHAuthorizationStatusAuthorized) {
        /// 用户开通了权限
    }else{
        /// 用户没有开通权限
    }
}];

///这里是PHAuthorizationStatus的所有枚举参数
typedef NS_ENUM(NSInteger, PHAuthorizationStatus) {
    PHAuthorizationStatusNotDetermined = 0, // 用户尚未作出关于这个应用的选择。
    PHAuthorizationStatusRestricted,        // 此应用程序未被授权访问照片数据。
                                            // 用户可能无法更改此应用程序的状态，可能是由于活动限制
                                            // 比如家长控制。
    PHAuthorizationStatusDenied,            // 用户已明确拒绝此应用程序访问照片数据。
    PHAuthorizationStatusAuthorized         // 用户已授权此应用程序访问照片数据。
}

2. PHAssetCollection

继承于PHCollection，它最主要的功能就是获取到对应的相册。通过相册我们就可以获取相册中的图片了。
这里是他最常用的方法：

// 通过这个方法以及PHAssetCollectionType和PHAssetCollectionSubtype参数，就能获取你想要的相册了。（下面我能翻译多少就翻译多少😂）
+ (PHFetchResult<PHAssetCollection *> *)fetchAssetCollectionsWithType:(PHAssetCollectionType)type subtype:(PHAssetCollectionSubtype)subtype options:(nullable PHFetchOptions *)options;

// PHAssetCollectionType的所有参数
typedef NS_ENUM(NSInteger, PHAssetCollectionType) {
    PHAssetCollectionTypeAlbum      = 1, // 相册，系统外的
    PHAssetCollectionTypeSmartAlbum = 2, // 智能相册，系统自己分配和归纳的
    PHAssetCollectionTypeMoment     = 3, // 时刻，系统自动通过时间和地点生成的分组
} PHOTOS_ENUM_AVAILABLE_IOS_TVOS(8_0, 10_0);

typedef NS_ENUM(NSInteger, PHAssetCollectionSubtype) {
    
    // PHAssetCollectionTypeAlbum regular subtypes
    PHAssetCollectionSubtypeAlbumRegular         = 2, // 在iPhone中自己创建的相册
    PHAssetCollectionSubtypeAlbumSyncedEvent     = 3, 
    PHAssetCollectionSubtypeAlbumSyncedFaces     = 4, // 从图片app中导入的人物照片
    PHAssetCollectionSubtypeAlbumSyncedAlbum     = 5, // 从图片app导入的相册
    PHAssetCollectionSubtypeAlbumImported        = 6,
    
    // PHAssetCollectionTypeAlbum shared subtypes
    PHAssetCollectionSubtypeAlbumMyPhotoStream   = 100, // 照片流，照片流和iCloud有关，如果在设置里关闭了iCloud开关，就获取不到了
    PHAssetCollectionSubtypeAlbumCloudShared     = 101, // iCloud的共享相册，点击照片上的共享tab创建后就能拿到了，但是前提是你要在设置中打开iCloud的共享开关（打开后才能看见共享tab）
    
    // PHAssetCollectionTypeSmartAlbum subtypes
    PHAssetCollectionSubtypeSmartAlbumGeneric    = 200, 
    PHAssetCollectionSubtypeSmartAlbumPanoramas  = 201, // 全景图、全景照片
    PHAssetCollectionSubtypeSmartAlbumVideos     = 202, // 视频
    PHAssetCollectionSubtypeSmartAlbumFavorites  = 203, // 标记为喜欢、收藏
    PHAssetCollectionSubtypeSmartAlbumTimelapses = 204, // 延时拍摄、定时拍摄
    PHAssetCollectionSubtypeSmartAlbumAllHidden  = 205, // 隐藏的
    PHAssetCollectionSubtypeSmartAlbumRecentlyAdded = 206, // 最近添加的、近期添加
    PHAssetCollectionSubtypeSmartAlbumBursts     = 207, // 连拍
    PHAssetCollectionSubtypeSmartAlbumSlomoVideos = 208,
    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);

ok，赶快举个获取全部相片例子：

// 获得相机胶卷
PHFetchResult<PHAssetCollection *> *cameraRolls = [PHAssetCollection fetchAssetCollectionsWithType:PHAssetCollectionTypeSmartAlbum subtype:PHAssetCollectionSubtypeSmartAlbumUserLibrary options:nil];

// cameraRolls：将来我们就用它来获取相册的图片

头大不？

不要慌，看这个参数感觉头大不要紧，一会看到demo的时候，简单的一批。

3.PHFetchResult

相册管理的类，是有序的photo实体对象的容器，包含通过给定的检索条件返回的asset，相册，一个相册类型中的所有相册列表。你要是实在搞不懂我说的是什么，你就把他想成NSMutableArray。（当然它和NSMutableArray只是用法上类似，他们之间没什么关系）

4.PHAsset

重头戏来了哈，这个就是需要重点介绍的。这个类相当于一张照片的实体，我们可以通过处理变成可见的照片，而且还能获取到照片的经纬度（前提是有经纬度）、创建时间，这对于产品来说是非常重要的参数。
我们就抽这个类几个重要的属性讲一下，其他同学们可以自学一下：

/// 像素宽高
@property (nonatomic, assign, readonly) NSUInteger pixelWidth;
@property (nonatomic, assign, readonly) NSUInteger pixelHeight;

/// 创建时间、修改时间
@property (nonatomic, strong, readonly, nullable) NSDate *creationDate;
@property (nonatomic, strong, readonly, nullable) NSDate *modificationDate;

/// 经纬度
@property (nonatomic, strong, readonly, nullable) CLLocation *location;

/// 持续时间
@property (nonatomic, assign, readonly) NSTimeInterval duration;

/// 通过PHAssetCollection获取PHFetchResult<PHAsset *> *，获取到PHAsset之后就可以得到图片了
+ (PHFetchResult<PHAsset *> *)fetchAssetsInAssetCollection:(PHAssetCollection *)assetCollection options:(nullable PHFetchOptions *)options;

哇，看到这些爽不爽啊，获取个图片，这么多相关属性都出来了。

5. PHImageManager

按照要求获取制定的图片

/// 通过PHAsset，加上你需要展示的图片大小、图片类型（是否裁剪等）和PHImageRequestOptions去获取图片
- (PHImageRequestID)requestImageForAsset:(PHAsset *)asset targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(nullable PHImageRequestOptions *)options resultHandler:(void (^)(UIImage *__nullable result, NSDictionary *__nullable info))resultHandler;

/// 这个就是调用的方法获取图片
[[PHImageManager defaultManager] requestImageForAsset:self.asset targetSize:CGSizeMake(imageWidth * [UIScreen mainScreen].scale, imageWidth * [UIScreen mainScreen].scale) contentMode:PHImageContentModeDefault options:options resultHandler:^(UIImage * _Nullable result, NSDictionary * _Nullable info) {
    NSLog(@"获取的图片：%@", result);
}];

6.PHImageRequestOptions

请求选项设置，这里也将它的重点属性讲解一下：

// resize mode. Does not apply when size is PHImageManagerMaximumSize. Defaults to PHImageRequestOptionsResizeModeNone (or no resize)
@property (nonatomic, assign) PHImageRequestOptionsResizeMode resizeMode;
// 自定义设置图片的大小
typedef NS_ENUM(NSInteger, PHImageRequestOptionsResizeMode) {
    PHImageRequestOptionsResizeModeNone = 0, // 保持原size（不调整大小）
    PHImageRequestOptionsResizeModeFast, //高效、但不保证图片的size为自定义size（由系统去安排，情况不定：有时你设置的size比较小，会根据你设的size，有时又会比大）
    PHImageRequestOptionsResizeModeExact, // 严格按照自定义size
} PHOTOS_ENUM_AVAILABLE_IOS_TVOS(8_0, 10_0);

// return only a single result, blocking until available (or failure). Defaults to NO
@property (nonatomic, assign, getter=isSynchronous) BOOL synchronous; 
// 指定请求是否同步执行。

// specify crop rectangle in unit coordinates of the original image, such as a face. Defaults to CGRectZero (not applicable)
@property (nonatomic, assign) CGRect normalizedCropRect;
// 用于对原始尺寸的图像进行裁剪，基于比例坐标。只在 resizeMode 为 Exact 时有效。

// delivery mode. Defaults to PHImageRequestOptionsDeliveryModeOpportunistic
@property (nonatomic, assign) PHImageRequestOptionsDeliveryMode deliveryMode; 
// 图像质量。有三种值：Opportunistic，在速度与质量中均衡；HighQualityFormat，不管花费多长时间，提供高质量图像；FastFormat，以最快速度提供好的质量。 这个属性只有在 synchronous 为 true 时有效。

ok，截止到目前，获取相册所有重要的类、参数、方法都讲完了。我们来讲讲demo吧。
我觉得整个demo的方法没有必要一条条的讲解，主要是思路和防止一些坑。

1.首先我们在进入控制器的时候，获取你需要显示的相册，再在主控制器显示第一个相册。
2.在加载图片的时候，我建议大家将加载的方法放在cell中完成，但是要保证cell的重用问题，千万不要把图片解析到model中，小心撑炸APP。
3.可以做一个单例，用于记录选中的图片、选中的总数等等。

其实大家把方法搞明白之后，整个demo的逻辑其实很简单。
demo的链接：传送门

喜欢的同学点个赞哈😘