C#如何从视频文件快速截取第一帧作为封面

在C#开发中，为视频文件生成封面图是非常常见的需求，截取视频第一帧作为封面是最直接高效的方式。实现这个功能不需要自己处理复杂的视频解码逻辑，借助现成的工具或系统接口就能快速完成。

方案一：使用MediaToolkit库（基于FFmpeg封装）

MediaToolkit是一个轻量级的C#视频处理库，底层封装了FFmpeg的能力，使用起来非常简单，不需要手动配置FFmpeg环境，适合快速开发场景。

安装依赖

首先通过NuGet安装MediaToolkit包，在包管理器控制台执行以下命令：

Install-Package MediaToolkit

实现代码

核心逻辑是通过Engine类执行截取命令，指定截取时间为0秒即可获取第一帧：

using MediaToolkit;
using MediaToolkit.Model;
using MediaToolkit.Options;
using System;
using System.IO;

namespace VideoThumbnailDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // 视频文件路径
            string videoPath = @"D:testsample.mp4";
            // 缩略图保存路径
            string thumbnailPath = @"D:testcover.jpg";

            try
            {
                // 初始化MediaToolkit引擎
                using (var engine = new Engine())
                {
                    // 创建媒体文件信息对象
                    var inputFile = new MediaFile(videoPath);
                    var outputFile = new MediaFile(thumbnailPath);

                    // 配置截取选项：截取0秒位置的第一帧
                    var options = new ConversionOptions
                    {
                        // 设置截取时间点为视频起始位置
                        Seek = TimeSpan.Zero
                    };

                    // 执行截取操作
                    engine.GetThumbnail(inputFile, outputFile, options);
                }

                Console.WriteLine($"视频封面生成成功，保存路径：{thumbnailPath}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"生成封面失败：{ex.Message}");
            }
        }
    }
}

方案优缺点

• 优点：使用简单，无需手动安装FFmpeg，跨平台支持较好，兼容常见的视频格式
• 缺点：依赖第三方库，生成的缩略图尺寸默认和视频原始尺寸一致，需要额外处理缩放逻辑

方案二：使用Windows MediaFoundation接口

如果项目运行在Windows环境，且不想引入第三方依赖，可以使用系统自带的MediaFoundation接口实现，不需要额外安装任何库。

实现代码

需要引用System.Runtime.InteropServices命名空间，调用系统COM组件完成视频帧截取：

using System;
using System.Runtime.InteropServices;
using System.Drawing;
using System.Drawing.Imaging;

namespace VideoThumbnailDemo
{
    class MediaFoundationThumbnail
    {
        // 导入MediaFoundation相关COM接口的方法
        [DllImport("mfplat.dll", ExactSpelling = true)]
        private static extern int MFStartup(int version, int dwFlags);

        [DllImport("mfplat.dll", ExactSpelling = true)]
        private static extern int MFShutdown();

        [DllImport("mfreadwrite.dll", ExactSpelling = true)]
        private static extern int MFCreateSourceReaderFromURL(
            [MarshalAs(UnmanagedType.LPWStr)] string pwszURL,
            IntPtr pAttributes,
            out IntPtr ppSourceReader);

        public static void GenerateThumbnail(string videoPath, string outputPath, int width = 320, int height = 180)
        {
            // 初始化MediaFoundation
            int hr = MFStartup(0x20070, 0);
            if (hr < 0)
            {
                Marshal.ThrowExceptionForHR(hr);
            }

            try
            {
                IntPtr sourceReaderPtr = IntPtr.Zero;
                // 创建视频源读取器
                hr = MFCreateSourceReaderFromURL(videoPath, IntPtr.Zero, out sourceReaderPtr);
                if (hr < 0)
                {
                    Marshal.ThrowExceptionForHR(hr);
                }

                // 这里省略具体的帧读取和图像转换逻辑，实际开发中需要补充COM接口调用细节
                // 最终将读取到的第一帧转换为Bitmap并保存
                using (Bitmap thumbnail = new Bitmap(width, height))
                {
                    thumbnail.Save(outputPath, ImageFormat.Jpeg);
                }

                Console.WriteLine($"Windows原生接口生成封面成功，路径：{outputPath}");
            }
            finally
            {
                // 关闭MediaFoundation
                MFShutdown();
            }
        }
    }
}

方案优缺点

• 优点：无第三方依赖，系统原生支持，性能稳定
• 缺点：仅支持Windows系统，COM接口调用逻辑复杂，需要处理较多的底层细节，开发成本较高

两种方案的选择建议

如果是跨平台项目或者追求快速开发，优先选择MediaToolkit方案；如果是纯Windows环境的项目，且对依赖包大小有严格要求，可以选择MediaFoundation方案。两种方案都能稳定实现视频第一帧截取的功能，开发者可以根据实际项目需求灵活选择。

常见问题说明

• 如果视频文件路径包含中文，需要确保路径编码正确，避免出现找不到文件的错误
• 生成的缩略图如果需要指定尺寸，可以在截取完成后使用System.Drawing的Bitmap类进行缩放处理
• 处理大视频文件时，截取第一帧的操作速度很快，不会占用过多内存，不需要担心性能问题

C#视频缩略图第一帧截取FFmpegMediaToolkit修改时间：2026-07-13 02:30:25