PHImageManager

  • 父类:NSObject

提供获取或生成预览缩略图和全尺寸图片,或者视频数据的方法。

一、概述

使用这些方法来获取全尺寸图片资源或缩略图,或者获取AV Foundation对象来播放、输出、控制视频资源

加载图片或视频数据:

  1. 使用PHAsset类来获取你想要的资源
  2. 调用+ (PHImageManager *)defaultManager;方法来获取图片管理单例对象。
  3. 使用“请求图片”和“请求视频对象”中的方法来加载资源的图片或视频数据。

图片管理器会缓存它提供过的图像和数据,所以之后向同一个资源请求同样的参数会很快速的返回。

如果你需要同时加载很多资源的图片数据,如果你想要很快速的加载图片请使用PHCachingImageManager预加载缓存。例如,你在一个展示资源的视图中想要使用缩略图填充,你可以在滚动到位置之前提前缓冲。

二、内容

1. 获得图片管理器

+ (PHImageManager *)defaultManager;

获得图片管理器单例。

2. 请求图片

- (PHImageRequestID)requestImageForAsset:(PHAsset *)asset targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(nullable PHImageRequestOptions *)options resultHandler:(void (^)(UIImage *__nullable result, NSDictionary *__nullable info))resultHandler;
  • asset PHAsset - 要获取的资源
  • targetSize CGSize - 想要获取的图片的大小。
  • contentMode PHImageContentMode - 图片的大小与纵横比的关系。
  • options PHImageRequestOptions - 告诉Photos如何处理请求,如何格式化图片,并且通知你的应用处理过程和错误。
  • resultHandler block - 加载完成图片后被调用。
  • result UIImage - 获取到的图片
  • info NSDictionary - 关于请求状态的信息。查看Image Result Info Keys获取可能出现的键合值。

获取给定资源的图片。
当你调用这个方法,Photos会加载或生成一个和你给定的大小一样或接近的图片。然后,它会调用你的resultHandler回调来返回这张图片。为了更快速的反应你的请求,Photos可能会提供一个略大于给定大小的图片——因为这张图片可能已经被缓存或者可以更有效率的生成这张图片。根据你给定的options以及资源的当前状态,Photos可能会从网络下载这个资源的数据。
默认情况下这个方法是异步执行的。如果你在后台的线程中调用这个方法,那么你可能需要改变options参数中的synchronous属性为YES以阻塞线程,直到图片被准备好或者发生错误,这个时候Photos会调用你的resultHandler
对于一个异步请求,Photos可能会不止一次的调用你的resultHandler回调。Photos第一次调用回调会提供一个合适的低质量图片作为临时展示,然后它会去准备一个高质量的图片。(如果低质量的图片立刻可以返回,那么第一次调用回调可能在方法返回一个返回值之前调用。)当高质量的图片准备好,Photos会再次调用你的resultHandler来提供这张图片。如果图片管理器已经缓存了请求的图片的全质量图片,Photos只会调用一次你的resultHandler。当Photos提供一个临时的低质量图片的时候,resultHandler中的info参数中的PHImageResultIsDegradedKey键会标示。
你可以使用这个方法获取照片和视频资源——对于一个视频资源,一个图片请求将提供一个缩略图或者关键帧。

PHImageContentMode

typedef NS_ENUM(NSInteger, PHImageContentMode) {
    PHImageContentModeAspectFit = 0, // 缩放图像,用更大的尺寸填充给定的目标尺寸。
    PHImageContentModeAspectFill = 1, // 缩放图像,使其完全填充给定的目标尺寸。
    PHImageContentModeDefault = PHImageContentModeAspectFit // 默认,PHImageContentModeAspectFit
} PHOTOS_ENUM_AVAILABLE_IOS_TVOS(8_0, 10_0);
- (PHImageRequestID)requestImageDataForAsset:(PHAsset *)asset options:(nullable PHImageRequestOptions *)options resultHandler:(void(^)(NSData *__nullable imageData, NSString *__nullable dataUTI, UIImageOrientation orientation, NSDictionary *__nullable info))resultHandler;
  • asset PHAsset - 要获取的资源
  • options PHImageRequestOptions - 告诉Photos如何处理请求,如何格式化图片,并且通知你的应用处理过程和错误。
  • resultHandler block - 加载完成图片后被调用。
  • imageData NSData - 获取到的图片数据。
  • dataUTI NSString - 请求的图片。
  • orientation UIImageOrientation - 图片的想要展示的方向。
  • info NSDictionary - 关于请求状态的信息。查看Image Result Info Keys获取可能出现的键合值。

获取给定资源的全尺寸图片。
当你调用这个方法,Photos加载这个图片资源的最大的表现形式,然后会调用你的resultHandler回调来提供这个数据。根据你给定的options以及资源的当前状态,Photos可能会从网络下载这个资源的数据。
默认情况下这个方法是异步执行的。如果你在后台的线程中调用这个方法,那么你可能需要改变options参数中的synchronous属性为YES以阻塞线程,直到图片被准备好或者发生错误,这个时候Photos会调用你的resultHandler。这个方法忽略deliveryMode选项——Photos只会调用一次你的resultHandler
如果version选项被设置为PHImageRequestOptionsVersionCurrentPhotos将会提供渲染的图片数据,包含了所有对资源内容的编辑结果。否则,Photos将会提供资源的最原始图像。

3. 请求视频对象

- (PHImageRequestID)requestPlayerItemForVideo:(PHAsset *)asset options:(nullable PHVideoRequestOptions *)options resultHandler:(void (^)(AVPlayerItem *__nullable playerItem, NSDictionary *__nullable info))resultHandler;
  • asset PHAsset - 要播放的视频资源
  • options PHVideoRequestOptions - 告诉Photos如何处理请求,并且通知你的应用处理过程和错误。
  • resultHandler block - 加载资源数据后被调用。
  • playerItem AVPlayerItem - 获取到的视频数据。
  • info NSDictionary - 关于请求状态的信息。查看Image Result Info Keys获取可能出现的键合值。

获取要播放的视频资源的表现形式,将被异步加载。
当你调用这个方法,Photos会下载这个视频数据(如果需要的话)并且创建一个播放项。然后调用你的resultHandler回调来提供请求获取的视频。
当你想要简单的播放存在的视频资源请使用这个方法。对于更多的选项详细信息或者使用资源的音频和视频轨道工作,则使用- (PHImageRequestID)requestAVAssetForVideo:(PHAsset *)asset options:(PHVideoRequestOptions *)options resultHandler:(void (^)(AVAsset *asset, AVAudioMix *audioMix, NSDictionary *info))resultHandler;方法。

- (PHImageRequestID)requestExportSessionForVideo:(PHAsset *)asset options:(nullable PHVideoRequestOptions *)options exportPreset:(NSString *)exportPreset resultHandler:(void (^)(AVAssetExportSession *__nullable exportSession, NSDictionary *__nullable info))resultHandler;
  • asset PHAsset - 将要被创建导出会话的视频资源
  • options PHVideoRequestOptions - 告诉Photos如何处理请求,并且通知你的应用处理过程和错误。
  • exportPreset NSString - 要导出的资源的导出预设名。请查看AVAssetExportSession。
  • resultHandler block - 加载资源数据并且准备导出会话后被调用。
  • exportSession AVAssetExportSession - 使用这个将视频资源数据写入文件
  • info NSDictionary - 关于请求状态的信息。查看Image Result Info Keys获取可能出现的键合值。

获取一个将视频资源的数据写入文件的导出会话,将被异步加载。
当你调用这个方法,Photos会下载这个视频数据(如果需要的话)并且创建一个导出会话。然后调用你的resultHandler回调来提供请求获取的视频。
对于额外的导出选项,使用- (PHImageRequestID)requestAVAssetForVideo:(PHAsset *)asset options:(PHVideoRequestOptions *)options resultHandler:(void (^)(AVAsset *asset, AVAudioMix *audioMix, NSDictionary *info))resultHandler;方法并且创建AVAssetReader和AVAssetWriter对象来转换和输出视频资源数据。

- (PHImageRequestID)requestAVAssetForVideo:(PHAsset *)asset options:(nullable PHVideoRequestOptions *)options resultHandler:(void (^)(AVAsset *__nullable asset, AVAudioMix *__nullable audioMix, NSDictionary *__nullable info))resultHandler;
  • asset PHAsset - 将要被加载的视频资源
  • options PHVideoRequestOptions - 告诉Photos如何处理请求,并且通知你的应用处理过程和错误。
  • resultHandler block - 加载资源数据后被调用。
  • asset AVAsset - 提供了访问视频资源轨道和数据的对象。关于AVAsset对象的更详细内容请查看AVFoundation Programming Guide。
  • audioMix AVAudioMix - 使用这个对象可以重新排列资源的音频轨道,编辑在组合中的附加音频,或者配置用来输出资源音频数据的AVAssetReaderOutput对象。如果这个参数为nil,那么这个资源使用的是默认音频组合。
  • info NSDictionary - 关于请求状态的信息。查看Image Result Info Keys获取可能出现的键合值。

请求代表了视频资源内容和状态的AV Foundation对象,将被异步加载。
当你调用这个方法,Photos会下载这个视频数据(如果需要的话)并且创建一个AV Foundation对象。然后调用你的resultHandler回调来提供请求获取的视频。
当你想要使用一个资源内容的音频和视频轨道工作请使用这个方法。如果你只想要播放资源,请使用- (PHImageRequestID)requestPlayerItemForVideo:(PHAsset *)asset options:(PHVideoRequestOptions *)options resultHandler:(void (^)(AVPlayerItem *playerItem, NSDictionary *info))resultHandler;方法。如果你想要导出资源数据,请调用- (PHImageRequestID)requestExportSessionForVideo:(PHAsset *)asset options:(PHVideoRequestOptions *)options exportPreset:(NSString *)exportPreset resultHandler:(void (^)(AVAssetExportSession *exportSession, NSDictionary *info))resultHandler;方法。

4. 请求Live Photos

- (PHImageRequestID)requestLivePhotoForAsset:(PHAsset *)asset targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(nullable PHLivePhotoRequestOptions *)options resultHandler:(void (^)(PHLivePhoto *__nullable livePhoto, NSDictionary *__nullable info))resultHandler;

从给定资源中获取Live Photos
一张Live Photo是一张图片,只有支持的设备才可以拍摄,它包含了捕捉之前和之后时刻的动作和声音。就像一个UIImage对象代表了一张随时可用的图片,一个PHLivePhoto对象代表了一个准备展示的图片、声音、动作数据的Live Photo。使用这个方法获取资源中的Live Photo,获取之后Photos会调用你的resultHandler回调来返回这个Live Photo,你可以使用PHLivePhotoView来展示Live Photo

注意
当你要展示Live Photo的动作和声音内容时使用这个方法。如果你只想展示Live Photo资源的静止图片——例如,当在照片选择界面加载缩略图来展示时——请使用- (PHImageRequestID)requestImageForAsset:(PHAsset *)asset targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(PHImageRequestOptions *)options resultHandler:(void (^)(UIImage *result, NSDictionary *info))resultHandler;方法。

当你调用这个方法,Photos会加载或生成一个和你提供的大小相近或相等大小的PHLivePhoto对象。然后调用你的resultHandler回调提供这个图片。为了更快速的反应你的请求,Photos可能会提供一个略大于给定大小的图片——因为这张图片可能已经被缓存或者可以更有效率的生成这张图片。根据你给定的options以及资源的当前状态,Photos可能会从网络下载这个资源的数据。此方法总是异步执行。
Photos可能会不止一次的调用你的resultHandler回调。Photos第一次调用回调会提供一个合适的低质量图片作为临时展示,然后它会去准备一个高质量的图片。(如果低质量的图片立刻可以返回,那么第一次调用回调可能在方法返回一个返回值之前调用。)当高质量的图片准备好,Photos会再次调用你的resultHandler来提供这张图片。如果图片管理器已经缓存了请求的图片的全质量图片,Photos只会调用一次你的resultHandler。当Photos提供一个临时的低质量图片的时候,resultHandler中的info参数中的PHImageResultIsDegradedKey键会被标示。

5. 取消一个请求

- (void)cancelImageRequest:(PHImageRequestID)requestID;

取消一个异步请求。
当你使用- (PHImageRequestID)requestImageForAsset:(PHAsset *)asset targetSize:(CGSize)targetSize contentMode:(PHImageContentMode)contentMode options:(PHImageRequestOptions *)options resultHandler:(void (^)(UIImage *result, NSDictionary *info))resultHandler;方法执行一个异步请求来请求图片数据,或者对一个视频对象使用上面的“请求视频对象”中的方法,图片管理器都会返回一个对应该请求的数字标识。想要在请求完成之前取消,请调用该方法并传入对应的数字标识。

你可能感兴趣的:(PHImageManager)