C#结合FFmpeg截取视频指定帧缩略图实现

Noah

发布时间：2026-10-14 | 3人浏览过

原创

在C#开发中，经常需要为视频文件生成预览封面或缩略图。通过调用命令行工具FFmpeg并嵌入C#代码执行，可以高效地提取视频指定时间点的单帧图像。本方法重点解决图像变形问题，确保缩略图按比例缩放且清晰。

实现原理与准备

要实现视频帧截图，核心逻辑是构造一条正确的FFmpeg命令并在C#中执行。FFmpeg是一个强大的音视频处理库，支持将视频流解码为图像序列。在开始编码前，需要准备以下内容：

FFmpeg可执行文件：下载FFmpeg并确认其在系统中的路径（如 ffmpeg.exe）。
输入视频文件：确定待处理视频的文件路径。
输出图片路径：指定生成的缩略图保存位置及文件名（支持jpg/bmp格式）。

关键步骤：保持比例与参数构建

直接固定宽高会导致图像拉伸变形。因此，必须先获取视频的实际分辨率，再根据目标展示区域进行等比缩放计算。

第1步：获取视频原始分辨率

首先需要读取视频的宽度和高度。可以使用FFprobe（通常随FFmpeg一起分发）解析视频元数据，或者使用MediaInfo等库。假设已获取到视频宽度为 videoWidth，高度为 videoHeight。

第2步：计算目标缩略图尺寸

设定一个最大显示边界（例如 maxLimit = 200 像素），计算缩放因子以适配该边界：

若 videoWidth > videoHeight，则新宽度为 maxLimit，新高度为 int(videoHeight * (maxLimit / videoWidth))。
否则，新高度为 maxLimit，新宽度为 int(videoWidth * (maxLimit / videoHeight))。

记计算后的尺寸为 targetWidth 和 targetHeight。

第3步：构建FFmpeg命令字符串

C#中使用 string.Format 拼接命令。关键参数说明：

-i：指定输入视频路径。
-ss：指定截取的时间点（秒），例如 00:00:01 表示第1秒。
-vframes 1：只提取1帧画面。
-s WxH：强制设置输出图像的尺寸，用于保持比例缩放。
-f image2：指定输出格式为图像序列。

示例命令模板如下：

string command = string.Format(
    "\"{0}\" -i \"{1}\" -ss {2} -vframes 1 -s {3}x{4} -y \"{5}\"",
    ffmpegPath,      // FFmpeg可执行文件完整路径
    oriVideoPath,    // 源视频路径
    frameIndex,      // 截取时间点，如 "00:00:01"
    targetWidth,     // 缩略图宽度
    targetHeight,    // 缩略图高度
    thumbImagePath   // 输出图片路径
);

注意：-y 参数表示如果输出文件已存在则自动覆盖，避免交互式询问。

实际操作：在C#中执行命令

使用 System.Diagnostics.Process 类来启动FFmpeg进程。

第4步：编写执行函数

以下代码展示了如何安全地执行上述命令：

using System;
using System.Diagnostics;

public bool GenerateThumbnail(string ffmpegExe, string videoFile, string outputFile, double timeSeconds, int width, int height)
{
    try
    {
        ProcessStartInfo startInfo = new ProcessStartInfo
        {
            FileName = ffmpegExe,
            Arguments = $"-i \"{videoFile}\" -ss {timeSeconds:0.0} -vframes 1 -s {width}x{height} -y \"{outputFile}\"",
            RedirectStandardOutput = true,
            RedirectStandardError = true,
            UseShellExecute = false,
            CreateNoWindow = true
        };

        using (Process process = Process.Start(startInfo))
        {
            process.WaitForExit();
            if (process.ExitCode == 0)
            {
                return System.IO.File.Exists(outputFile);
            }
            else
            {
                string error = process.StandardError.ReadToEnd();
                Console.WriteLine($"FFmpeg Error: {error}");
                return false;
            }
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Execution failed: {ex.Message}");
        return false;
    }
}