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的链接:传送门

喜欢的同学点个赞哈😘

推荐阅读更多精彩内容