AVFoundation框架解析看这里（7）- AVAssetImageGenerator

AVFoundation框架是ios中很重要的框架，所有与视频音频相关的软硬件控制都在这个框架里面，接下来这几篇就主要对这个框架进行介绍和讲解。
便于读者查阅这个AVFoundation框架系列，在此提供目录直通车。
AVFoundation框架解析目录
AVFoundation框架解析目录
AVFoundation框架解析目录

本章导读

AVAssetImageGenerator，用来提供视频的缩略图或预览视频的帧的类。在很多视频软件中，基本都会提供跟随鼠标进度显示画面，裁剪视频时预览关键帧等功能，实际上，这种类似的功能都是AVAssetImageGenerator的功劳。

属性

/*
初始化 AVAssetImageGenerator的AVAsset实例。
*/

open var asset: AVAsset { get }

/*
指定在从asset中提取图像时是否应用track的preferredTransform（AVAssetTrack preferredTransform中会有详细说明）。
默认为NO。仅支持旋转90度，180度或270度。
*/
open var appliesPreferredTrackTransform: Bool

/*
指定生成的图像的最大尺寸。默认（CGSizeZero）是asset的未缩放尺寸。
*/
 open var maximumSize: CGSize

/*
*/
open var apertureMode: AVAssetImageGenerator.ApertureMode?

/*
*/
@NSCopying open var videoComposition: AVVideoComposition?

/*
表示使用的自定义视频合成器实例（如果有的话）
*/
open var customVideoCompositor: AVVideoCompositing? { get }

/*
生成的图像的实际时间将在[requestedTime-toleranceBefore，requestedTime + toleranceAfter]范围内，并且可能与请求的效率时间不同。

通过kCMTimeZero for toleranceBefore和toleranceAfter请求帧精确图像生成;这可能会导致额外的解码延迟。

默认值是kCMTimePositiveInfinity。
*/
open var requestedTimeToleranceBefore: CMTime

open var requestedTimeToleranceAfter: CMTime

• 方法

/*
初始化一个AVAssetImageGenerator，你必须一直持有generator的引用，直到生成所有的图片。
*/
public init(asset: AVAsset)

/*
 * 生成一张指定时间点的图片
 * 不一定能精确的生成一张你所指定时间的图片，所以有两个参数
 * requestedTime:  生成图片的指定时间
 * actualTime:  生成图片的精确时间
*/
open func copyCGImage(at requestedTime: CMTime, actualTime: UnsafeMutablePointer?) throws -> CGImage

/*
 * 生成一系列图片
 * requestedTimes:  NSValue类型的数组，数组里每一个对象都是CMTime结构体，表示你想要生成的图片在视频中的时间点
 * block  每生成一张图片都会回调这个block，这个block提供一个result的参数告诉你图片是否成功生成或者图片生成操作是否取消。
*/
open func generateCGImagesAsynchronously(forTimes requestedTimes: [NSValue], completionHandler handler: @escaping AVAssetImageGeneratorCompletionHandler)

/*
取消生成图片的操作
*/
open func cancelAllCGImageGeneration()

• 回调

public typealias AVAssetImageGeneratorCompletionHandler = (CMTime, CGImage?, CMTime, AVAssetImageGenerator.Result, Error?) -> Void

应用场景：

视频帧预览

实际上就是基于AVAssetImageGenerator实现的功能。

typealias SplitVideoBlock = ([UIImage]) -> ()      //获取视频帧后的回调


 /*
    按照指定的帧率，把视频文件拆成图片
     
    返回AVAssetImageGenerator，能够取消
    */
    @discardableResult
    class func splitVideo(asset: AVURLAsset, fps: Double, completedBlock: @escaping SplitVideoBlock) -> AVAssetImageGenerator {
        let duration = asset.duration.seconds  //总时长
        let totalFrames = duration * fps       //总帧数
              
        var times = [NSValue]()
        for i in 1...UInt64(totalFrames) {
            times.append(NSValue(time: CMTimeMake(value: Int64(i), timescale: Int32(fps))))
        }
        
        var images = [UIImage]()
        let imagesGenerator = AVAssetImageGenerator(asset: asset)
        
        //防止时间出现偏差
        imagesGenerator.requestedTimeToleranceBefore = .zero
        imagesGenerator.requestedTimeToleranceAfter = .zero
        imagesGenerator.generateCGImagesAsynchronously(forTimes: times) { (requestedTime, image, actualTime, result, error) in
            switch result {
            case .cancelled:
                break
            case .failed:
                break
            case .succeeded:
                if let _image = image {
                    images.append(UIImage(cgImage: _image))
                }
            break
            @unknown default:
                break
            }
            
            print("current is: \(requestedTime.value), total is: \(times.count)")
            if requestedTime.value == times.count {
                completedBlock(images)
            }
        }
        
        return imagesGenerator
    }