iOS 视频图像相关iOS Photos详解音视频及流媒体

PHImageManager

2017-05-08  本文已影响342人  Shmily落墨

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

一、概述

使用这些方法来获取全尺寸图片资源或缩略图，或者获取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;

获取给定资源的图片。
当你调用这个方法，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;

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

3. 请求视频对象

- (PHImageRequestID)requestPlayerItemForVideo:(PHAsset *)asset options:(nullable PHVideoRequestOptions *)options resultHandler:(void (^)(AVPlayerItem *__nullable playerItem, NSDictionary *__nullable info))resultHandler;

获取要播放的视频资源的表现形式，将被异步加载。
当你调用这个方法，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;

获取一个将视频资源的数据写入文件的导出会话，将被异步加载。
当你调用这个方法，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;

请求代表了视频资源内容和状态的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;方法执行一个异步请求来请求图片数据，或者对一个视频对象使用上面的“请求视频对象”中的方法，图片管理器都会返回一个对应该请求的数字标识。想要在请求完成之前取消，请调用该方法并传入对应的数字标识。

上一篇 下一篇

猜你喜欢

热点阅读