今天给大家讲一个干货,简单实用。之前公司的项目需要自定义相册,并且需要获取图片的经纬度信息,使用UIImagePickerController自然是实现不了的。所以就用到了我们今天所说的PhotoKit框架,因为PhotoKit是iOS8之后出的,所以iOS8以前的项目是不能使用的(可以使用AssetsLibrary,这里就不多介绍了)。
先来介绍一下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的链接:传送门
喜欢的同学点个赞哈😘