如何在 iOS 中将多张 WebP 图像转换为视频

在 iOS 中将多张 WebP 图像（通常是动图或序列帧）转换为视频，核心逻辑是利用 AVAssetWriter 将解码后的像素数据（CVPixelBuffer）按时间顺序写入到一个视频文件中。

由于 iOS 原生 UIImage 对 WebP 的支持在不同版本有所差异（iOS 14+ 支持较好），通常建议配合 libwebp 或 SDWebImageWebPCoder 来确保解码的兼容性。

1、转换流程架构

解码阶段：将 WebP 动图拆解为每一帧的 UIImage 或 CGImage。
缓冲区准备：创建一个 CVPixelBufferPool，将 CGImage 绘制到 CVPixelBuffer 中。
写入阶段：使用 AVAssetWriterInputPixelBufferAdaptor 按指定帧率将 Buffer 压入视频流。

2、Objective-C 代码实现

以下是一个将 WebP 图像序列转换为 MP4 视频的核心类实现：

#import <AVFoundation/AVFoundation.h>
#import <VideoToolbox/VideoToolbox.h>

@implementation WebPToVideoConverter

- (void)convertImages:(NSArray<UIImage *> *)images toPath:(NSString *)outputPath {
    // 1. 初始化视频输出配置
    NSError *error = nil;
    NSURL *videoURL = [NSURL fileURLWithPath:outputPath];
    AVAssetWriter *videoWriter = [[AVAssetWriter alloc] initWithURL:videoURL 
                                                           fileType:AVFileTypeMPEG4
                                                              error:&error];
    
    // 设置 H.264 编码参数
    NSDictionary *videoSettings = @{
        AVVideoCodecKey: AVVideoCodecTypeH264,
        AVVideoWidthKey: @(images.firstObject.size.width),
        AVVideoHeightKey: @(images.firstObject.size.height),
    };
    
    AVAssetWriterInput *writerInput = [AVAssetWriterInput assetWriterInputWithMediaType:AVMediaTypeVideo
                                                                         outputSettings:videoSettings];
    
    // 2. 创建适配器（用于输入 CVPixelBuffer）
    AVAssetWriterInputPixelBufferAdaptor *adaptor = [AVAssetWriterInputPixelBufferAdaptor
        assetWriterInputPixelBufferAdaptorWithAssetWriterInput:writerInput 
        sourcePixelBufferAttributes:@{(id)kCVPixelBufferPixelFormatTypeKey: @(kCVPixelFormatType_32ARGB)}];
    
    [videoWriter addInput:writerInput];
    [videoWriter startWriting];
    [videoWriter startSessionAtSourceTime:kCMTimeZero];
    
    // 3. 循环写入帧
    NSInteger __block frameCount = 0;
    CGFloat durationPerFrame = 0.1; // 假设每帧 100ms (10fps)
    
    [writerInput requestMediaDataWhenReadyOnQueue:dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0) usingBlock:^{
        while ([writerInput isReadyForMoreMediaData] && frameCount < images.count) {
            UIImage *image = images[frameCount];
            CVPixelBufferRef buffer = [self pixelBufferFromCGImage:image.CGImage size:image.size];
            
            if (buffer) {
                CMTime presentationTime = CMTimeMake(frameCount, 10); // 10 为帧率
                if (![adaptor appendPixelBuffer:buffer withPresentationTime:presentationTime]) {
                    NSLog(@"写入失败: %@", videoWriter.error);
                }
                CFRelease(buffer);
            }
            frameCount++;
        }
        
        if (frameCount >= images.count) {
            [writerInput markAsFinished];
            [videoWriter finishWritingWithCompletionHandler:^{
                NSLog(@"视频转换完成: %@", outputPath);
            }];
        }
    }];
}

// 辅助方法：CGImage 转 CVPixelBuffer
- (CVPixelBufferRef)pixelBufferFromCGImage:(CGImageRef)image size:(CGSize)size {
    NSDictionary *options = @{(id)kCVPixelBufferCGImageCompatibilityKey: @YES,
                             (id)kCVPixelBufferCGBitmapContextCompatibilityKey: @YES};
    CVPixelBufferRef pxbuffer = NULL;
    CVPixelBufferCreate(kCFAllocatorDefault, size.width, size.height, kCVPixelFormatType_32ARGB, (__bridge CFDictionaryRef)options, &pxbuffer);
    
    CVPixelBufferLockBaseAddress(pxbuffer, 0);
    void *pxdata = CVPixelBufferGetBaseAddress(pxbuffer);
    
    CGColorSpaceRef rgbColorSpace = CGColorSpaceCreateDeviceRGB();
    CGContextRef context = CGBitmapContextCreate(pxdata, size.width, size.height, 8, 4 * size.width, rgbColorSpace, kCGImageAlphaPremultipliedFirst);
    
    CGContextDrawImage(context, CGRectMake(0, 0, size.width, size.height), image);
    
    CGColorSpaceRelease(rgbColorSpace);
    CGContextRelease(context);
    CVPixelBufferUnlockBaseAddress(pxbuffer, 0);
    
    return pxbuffer;
}

@end