Reference: http://www.jianshu.com/p/cc85282fac5e
Phtots框架:
1.PHAsset:包含具体的每个照片的资源信息. 看看些常用的 api
(1).资源的原信息.
mediaType:PHAssetMediaType类型的枚举值:
PHAssetMediaTypeUnknown 不知类型
PHAssetMediaTypeImage 图片
PHAssetMediaTypeVideo 视屏
PHAssetMediaTypeAudio 音频
(2).资源的子类型.
mediaSubtypes:PHAssetMediaSubtype类型的枚举值:
PHAssetMediaSubtypeNone 没有任何子类型
相片子类型
PHAssetMediaSubtypePhotoPanorama 全景图
PHAssetMediaSubtypePhotoHDR 滤镜图
PHAssetMediaSubtypePhotoScreenshot 截屏图
PHAssetMediaSubtypePhotoLive 1.5s 的 photoLive
视屏子类型
PHAssetMediaSubtypeVideoStreamed 流体
PHAssetMediaSubtypeVideoHighFrameRate 高帧视屏
PHAssetMediaSubtypeVideoTimelapse 延时拍摄视频
(3).获得 PHAsset 的集合.
+ (PHFetchResult<PHAsset *> *)fetchAssetsWithOptions:(nullable PHFetchOptions *)options;
2.PHAssetCollection:PHCollection的子类,相册分类,一系列的相册.如:最近删除,精选等.
1> 相册类型
assetCollectionType;
PHAssetCollectionType的枚举值:
PHAssetCollectionTypeAlbum 相册
PHAssetCollectionTypeSmartAlbum 智能相册
PHAssetCollectionTypeMoment 时刻
2> 相册的子类型
assetCollectionSubtype;
PHAssetCollectionSubtype枚举类型:
常规的子类型
PHAssetCollectionSubtypeAlbumRegular 常规的
PHAssetCollectionSubtypeAlbumSyncedEvent 使用 iTunes 同步操作过来的相册
PHAssetCollectionSubtypeAlbumSyncedFaces 使用 iTuens同步操作过来的人物相册
PHAssetCollectionSubtypeAlbumSyncedAlbum 使用iTunes 同步的所有相册
PHAssetCollectionSubtypeAlbumImported 从外界导入的相册
经分享的子类型
PHAssetCollectionSubtypeAlbumMyPhotoStream 从相册分享得到
PHAssetCollectionSubtypeAlbumCloudShared 从 cloud 分享得到
智能相册子类型
PHAssetCollectionSubtypeSmartAlbumGeneric 通用的
PHAssetCollectionSubtypeSmartAlbumPanoramas 全景
PHAssetCollectionSubtypeSmartAlbumVideos 视屏
PHAssetCollectionSubtypeSmartAlbumFavorites 收藏
PHAssetCollectionSubtypeSmartAlbumTimelapses 延时视屏,也会在PHAssetCollectionSubtypeSmartAlbumVideos在出现
PHAssetCollectionSubtypeSmartAlbumAllHidden 隐藏的
PHAssetCollectionSubtypeSmartAlbumRecentlyAdded 最近添加
PHAssetCollectionSubtypeSmartAlbumBursts 连拍
PHAssetCollectionSubtypeSmartAlbumSlomoVideos Slomo是slow motion的缩写,高速摄影慢动作解析
PHAssetCollectionSubtypeSmartAlbumUserLibrary 用户所有的资源
PHAssetCollectionSubtypeSmartAlbumSelfPortraits 所有前置摄像头拍的照片和视屏
PHAssetCollectionSubtypeSmartAlbumScreenshots 所有的截屏图
不关心子类型时的全部资源
PHAssetCollectionSubtypeAny = NSIntegerMax
3> 相册查询
/// 获取所有的相册, 对应 iOS系统中
let collections2 = PHAssetCollection.fetchAssetCollections(with: .album, subtype: .smartAlbumUserLibrary, options: PHFetchOptions())
3.PHFetchOptions
对使用 PHAsset, PHCollection, PHAssetCollection, 和 PHCollectionLis 的方法时出入的参数,主要对获取到资源做一些配置和排序等,一般为 nil, 默认使用系统的.
(1).排序
sortDescriptors;
(2).是否显示隐藏的相册,默认不显示
includeHiddenAssets
(3).获取到相册的类型
includeAssetSourceTypes;
PHAssetSourceType类型的枚举,默认PHAssetSourceTypeNone
PHAssetSourceTypeNone 都没有,就获得到就是常规的
PHAssetSourceTypeUserLibrary 用户所有的
PHAssetSourceTypeCloudShared 分享的
PHAssetSourceTypeiTunesSynced iTunes 同步的
4.PHFetchResult:相册资源,包括相册中图片的数量和获取.看些常用 api
(1).相册中图片的数量
count
(2).遍历得到相册资源中每个相册组的信息.
- (void)enumerateObjectsUsingBlock:(void (^)(ObjectType obj, NSUInteger idx, BOOL *stop))block;
block为成功回调,定义为:void (^)(ObjectType obj, NSUInteger idx, BOOL *stop);
obj:改参数由遍历他的集合决定,如果是PHAssetCollection 的 api 获得.那么他就是PHAssetCollection的对象,包括每组相册的一些信息;
如果是PHAsset api 获得,那他就是 PHAsset 对象,包含具体的每张图片的信息.
idx:遍历时每组相册对应在集合中的下标.
stop:用于在某时刻停止遍历资源.
5.PHImageManager:管理 PHAsset 的一个类,相当于对一个具体资源更好地管理和筛选
(1).获得该实例.
+ (PHImageManager *)defaultManager;
(2).经删选和限制条件获得具体的资源UIImage.
- (PHImageRequestID)requestImageForAsset:(PHAsset *)asset
targetSize:(CGSize)targetSize
contentMode:(PHImageContentMode)contentMode
options:(nullable PHImageRequestOptions *)options resultHandler:(void (^)(UIImage *__nullable result, NSDictionary *__nullable info))resultHandler;
返回值: PHImageRequestID,是个常量,定义为:static const PHImageRequestID PHInvalidImageRequestID = 0;
asset:想要获得信息的PHAsset的对象,
targetSize:获得图片的尺寸大小,这里的大小是pixel,所以换算乘以[UIScreen mainScreen].scale.获得自己想要的尺寸.
如果想要原图的尺寸,直接传入PHImageManagerMaximumSize.很大很大的尺寸,系统会默认返回原图的尺寸,要注意的是传入PHImageManagerMaximumSize时,则 contentMode 无论传入什么值都会被视为PHImageContentModeDefault.
contentMode:想要图片的裁剪方式, PHImageContentMode的枚举:
PHImageContentModeAspectFit 适合的
PHImageContentModeAspectFill 铺满的
PHImageContentModeDefault = PHImageContentModeAspectFit
options: PHImageRequestOptions的实例,包括控制图片版本,质量,裁剪参数等的一个类.
resultHandler:成功回调block,
result:获取到的具体图片,
info:关于图片的一些信息,如是否来自 cloud, 是否是原图等.
6.PHCachingImageManager: PHImageManager的子类,读获取图片的过程做缓存和清理的一个类
(1).缓存操作.
- (void)startCachingImagesForAssets:(NSArray<PHAsset *> *)assets
targetSize:(CGSize)targetSize
contentMode:(PHImageContentMode)contentMode
options:(nullable PHImageRequestOptions *)options;
assets:要缓存获取 PHAsset 类型对象的集合.
targetSize:获取时的尺寸.
contentMode:裁剪方法,
options:传入的控制参数类.
(2).取消缓存操作.
- (void)stopCachingImagesForAssets:(NSArray<PHAsset *> *)assets targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(nullable PHImageRequestOptions *)options;
assets:要缓存获取 PHAsset 类型对象的集合.
targetSize:获取时的尺寸.
contentMode:裁剪方法,
options:传入的控制参数类.
7.PHImageRequestOptions:控制加载图片参数的一个类
(1).控制图片质量和获取速度的 api
deliveryMode.
PHImageRequestOptionsDeliveryMode类型的枚举,只有synchronous属性设置为 YES,即异步获取有限
PHImageRequestOptionsDeliveryModeOpportunistic 图片质量和获取速度均衡
PHImageRequestOptionsDeliveryModeHighQualityFormat 获取高质量图片,不保证获取速度
PHImageRequestOptionsDeliveryModeFastFormat 快速获得,不保证质量
(2).裁剪的方式
resizeMode.
PHImageRequestOptionsResizeMode类型的枚举:
PHImageRequestOptionsResizeModeNone 不设置 PHImageRequestOptionsResizeModeFast 返回的图像可能和目标大小不一样并且质量较低,但效率高.
PHImageRequestOptionsResizeModeExact 返回图像必须和目标大小相匹配,并且图像质量也为高质量图像
8.PHPhotoLibrary:相册权限管理,监听相册增删等
(1).获得实例
+ (PHPhotoLibrary *)sharedPhotoLibrary;
(2).获得当前用户授权情况
+ (PHAuthorizationStatus)authorizationStatus;
返回一个PHAuthorizationStatus类型的枚举:
PHAuthorizationStatusNotDetermined 用户还未选择
PHAuthorizationStatusRestricted 家长模式 不允许
PHAuthorizationStatusDenied 不同意访问
PHAuthorizationStatusAuthorized 同意访问
9.PHAssetChangeRequest
1> 负责执行对PHAsset的[增删改]操作. 2> 这个类只能放在PHPhotoLibrary.shared().performChangesAndWait()和PHPhotoLibrary.shared().performChanges(, completionHandler:)方法的闭包中使用.
10.PHAssetCollectionChangeRequest
1> 负责对PHAssetCollection的增删改操作. 2> 2> 这个类只能放在PHPhotoLibrary.shared().performChangesAndWait()和PHPhotoLibrary.shared().performChanges(, completionHandler:)方法的闭包中使用.
11.一些示例代码
/// 0.查询所有的资源不分类型(图片, 视频, 音频)
let assets = PHAsset.fetchAssets(with: PHFetchOptions())
/// 1.获取所有的相册, 对应 iOS系统中 照片>相薄>我的相薄
let collections2 = PHAssetCollection.fetchAssetCollections(with: .album, subtype: .smartAlbumUserLibrary, options: PHFetchOptions())
/// 2.获取所有的照片并放在一个PHAssetCollection对象里面
let collections3 = PHAssetCollection.fetchAssetCollections(with: .smartAlbum, subtype: .smartAlbumUserLibrary, options: PHFetchOptions())
for index in 0..<collections3.count {
print(collections3[index].localizedTitle)
}
/// 3.获取所有的图片资源(PHAsset对象)
let assets1 = PHAsset.fetchAssets(with: .image, options: PHFetchOptions())
let options = PHImageRequestOptions()
options.isSynchronous = true //是否同步
/// 4.从查询结果中获取每个图片
for index in 0..<assets1.count {
let asset = assets1[index]
let size = CGSize(width: asset.pixelWidth, height: asset.pixelHeight)
//获取原图的方法
// PHImageManager.default().requestImage(for: asset, targetSize: size, contentMode: .default, options: options, resultHandler: { (image, info) in
// if image != nil {
// self.imageArray.append(image!)
// }
// })
//获取缩略图的方法
PHImageManager.default().requestImage(for: asset, targetSize: CGSize.zero, contentMode: .aspectFill, options: options, resultHandler: { (image, info) in
if image != nil {
self.imageArray.append(image!)
}
})
}