Phtots框架简介

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!)
                }
            })
        }

转载于:https://my.oschina.net/whforever/blog/1553249

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值