如何使用FFMpegCore通过流生成视频首帧缩略图？

正确实现代码 #

var videoStream = file.OpenReadStream();
var outputStream = new MemoryStream();

FFMpegArguments
    .FromPipeInput(new StreamPipeSource(videoStream)
        // 根据你的视频实际格式手动指定，比如mp4、mov、avi等
        .ForceFormat("mp4"))
    .OutputToPipe(new StreamPipeSink(outputStream), opt => opt
        // 偏移0.1秒避免黑屏首帧，可选
        .Seek(TimeSpan.FromSeconds(0.1))
        // JPEG用Mjpeg编码器，PNG则用VideoCodec.Png
        .WithVideoCodec(VideoCodec.Mjpeg)
        .ForceFormat("image2pipe")
        .WithFrameOutputCount(1)
        .Resize(650, 390)
        // 指定通用像素格式，避免编码兼容问题
        .WithPixelFormat(PixelFormat.Yuv420p)
    )
    .ProcessSynchronously();

// 重置输出流位置，方便后续读取使用
outputStream.Position = 0;

关键修改说明 #

• 明确输入格式：管道模式下FFmpeg无法自动探测输入流格式，必须通过.ForceFormat()指定视频的实际格式（如mp4），否则FFmpeg无法解析输入流，直接导致管道断开。
• 编码器与输出格式匹配：管道输出图像必须用image2pipe作为容器格式，再搭配对应编码器：JPEG用Mjpeg，PNG用Png。之前直接指定jpeg作为输出格式，FFmpeg无法识别管道输出的格式规则，引发错误。
• 首帧时间偏移：避免直接读取TimeSpan.Zero位置的帧（很多视频首帧为黑屏），同时也能规避FFmpeg在处理0秒位置时的潜在解析异常。
• 指定像素格式：添加.WithPixelFormat(PixelFormat.Yuv420p)确保输出格式为FFmpeg通用兼容格式，减少编码阶段的格式冲突。
• 重置输出流位置：处理完成后将输出流指针移到开头，否则后续读取会从流末尾开始，无法获取生成的缩略图数据。

额外注意事项 #

• 确保服务器已安装最新稳定版FFmpeg，老旧版本可能存在管道模式的兼容性问题。
• 如果输入流是不可Seek的网络流，需先将流复制到MemoryStream中再处理，因为FFmpeg解析视频时需要回溯读取元数据。

内容的提问来源于stack exchange，提问作者l.diazborg