如果看过了之前的三片文章,其实会发现自始至终,除了有几个和系统的交互会展示一张图片外,一张图片都没有看到,我们一直看到的只是一个数字或者简单的信息。
如果一定要来做个比喻的话,前面介绍的都是准备的子弹,现在缺少一个能使用子弹的枪,而且是冲锋枪,而这个冲锋枪就是PHImageManager。
通过PHImageManager我们可以获取到确切的图片并展示出来,其使用过程也很简单,针对Image、Live Photo、Video都有不同的方法相对应。
下面就简单的看看Image相关的使用吧。
PHImageManager
注意⚠️:该类下的size都是像素单位,并不是之前常用的点。因为苹果的不同手机的分辨率不同,所以在得到像素之前,要先获取比例,使用方法[UIScreen mainScreen].scale
即可获取到,然后就可转换为相应的像素单位。
其使用步骤,苹果在其官方文档中也做了如下说明:
1、使用PHAsset获取到你想要的资源
2、使用类方法[PHImageManager defaultManager]
获取到PHImageManager对象
3、调用PHImageManager相关的方法获取数据
上面的三步,最难的就是第三步,因为这里的每个方法的注意点都不一样。目前,就只是针对图片的两个方法做个简单的介绍吧,其他的如果在后面有需求或者时间,再做更新:
- (PHImageRequestID)requestImageForAsset:(PHAsset *)asset targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(nullable PHImageRequestOptions *)options resultHandler:(void (^)(UIImage *__nullable result, NSDictionary *__nullable info))resultHandler;
- (PHImageRequestID)requestImageDataForAsset:(PHAsset *)asset options:(nullable PHImageRequestOptions *)options resultHandler:(void(^)(NSData *__nullable imageData, NSString *__nullable dataUTI, UIImageOrientation orientation, NSDictionary *__nullable info))resultHandler;
-
- (PHImageRequestID)requestImageForAsset:(PHAsset *)asset targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(nullable PHImageRequestOptions *)options resultHandler:(void (^)(UIImage *__nullable result, NSDictionary *__nullable info))resultHandler;
参数说明:
1、asset:要展示的那个图片的资源
2、targetSize:想要返回的图片的尺寸,注意这里的单位是像素;另外,还有一个全局常量,用来表示图片的原始尺寸或者尽可能大的尺寸:PHImageManagerMaximumSize,使用该常量,会忽略参数contentMode,它一般得到的是原图
3、contentMode:是个枚举,有两个值可供选择:PHImageContentModeAspectFit(默认)
和PHImageContentModeAspectFill
其意义和UIImageView的contentMode是相通的,前者按比例放大,直到有一边到了边界就不再放大,该模式下你会看到完整的图片,但是有可能会有空白;后者按比例放大,直到两条边里的最后一对到达边界,该模式下的到的图片可能会存在有一对边超出边界的情况,造成图片缺失。
4、options:用来定义一些属性,其中最常用的属性应该是isSynchronous
,该属性定义了是异步执行还是同步执行,需要注意的是如果是同步执行的话,该请求是不能被停止的;另一个属性是networkAccessAllowed
,表示是否允许从iCloud请求图片。
需要注意的是,如果实在异步线程中,这里的返回不一定就是在异步线程,也不一定就是在主线程。
1、options的synchronous设置为YES
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
PHImageRequestOptions * options = [[PHImageRequestOptions alloc] init];
options.synchronous = YES;
[[PHImageManager defaultManager] requestImageForAsset:_dataSourceArr.firstObject.asset targetSize:_thumbilImageSize contentMode:PHImageContentModeAspectFill options:options resultHandler:^(UIImage * _Nullable result, NSDictionary * _Nullable info) {
NSLog(@"%@", [NSThread currentThread]);
}];
NSLog(@"finished");
});
这种情况下,打印log可以看出是在当前线程同步执行返回的,而且只执行一次
2、options为nil,或者说options的synchronous设置为NO
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
NSLog(@"before:%@", [NSThread currentThread]);
[[PHImageManager defaultManager] requestImageForAsset:_dataSourceArr.firstObject.asset targetSize:_thumbilImageSize contentMode:PHImageContentModeAspectFill options:nil resultHandler:^(UIImage * _Nullable result, NSDictionary * _Nullable info) {
NSLog(@"request:%@", [NSThread currentThread]);
}];
NSLog(@"finished");
});
打印log可以看出,会在当前线程异步执行多次,除了最后一次会在主线程返回之外,其他的都在当前线程执行。
3、size为PHImageManagerMaximumSize
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
NSLog(@"before:%@", [NSThread currentThread]);
[[PHImageManager defaultManager] requestImageForAsset:_dataSourceArr.firstObject.asset targetSize:PHImageManagerMaximumSize contentMode:PHImageContentModeAspectFill options:nil resultHandler:^(UIImage * _Nullable result, NSDictionary * _Nullable info) {
NSLog(@"request:%@", [NSThread currentThread]);
}];
NSLog(@"finished");
});
从log中可以看出,异步执行,只执行一次,并且是在主线程中。
- (PHImageRequestID)requestImageDataForAsset:(PHAsset *)asset options:(nullable PHImageRequestOptions *)options resultHandler:(void(^)(NSData *__nullable imageData, NSString *__nullable dataUTI, UIImageOrientation orientation, NSDictionary *__nullable info))resultHandler;