简介这是一份面向C#初学者与桌面应用开发者的摄像头测试源代码聚焦C#与硬件交互、视频流捕获及图像处理入门适合需要快速验证摄像头功能或为二次开发打基础的开发者。压缩包共36个文件约482KB以10个dll类库、6个cs源码文件为主另含exe可执行程序、pdb调试符号、resx与resources资源文件及sln解决方案、csproj工程文件结构完整可直接编译运行。代码基于AForge.NET系列组件实现涵盖设备枚举、摄像头初始化、预览流显示、单帧图像捕获与保存等核心环节并预留了亮度对比度调整、人脸识别等扩展空间。已有296人学习下载读者可借此理解DirectShow与Media Foundation两种框架的调用差异掌握后台线程处理帧数据、PictureBox实时刷新及设备未连接等异常处理思路是一份便于上手调试与功能扩展的实用参考代码。1. 从一次“摄像头打不开”的现场说起这份 C# 摄像头测试源代码到底能干什么上周帮一个做产线检测的朋友看问题他那边一台工控机上跑着视觉程序早上开机摄像头死活出不来图像重启软件没用换 USB 口也没用最后发现是另一个后台进程把设备独占了。这种“摄像头打不开”的现场几乎每个碰过 C# 摄像头采集的人都会遇到。而这份 C# 摄像头测试源代码就是用来把这类问题从“玄学”变成“可复现、可定位”的。它本质上是一套基于 C# 的摄像头枚举、预览、参数读取与抓拍的最小可运行工程适合刚接触 C# 摄像头开发的新手照着跑通第一帧也适合熟手拿它当排错基线——当你的正式项目出问题时先用它确认是设备层、驱动层还是业务层的问题。它不解决所有事但能帮你把“摄像头到底能不能用”这件事先钉死。2. 摄像头枚举与设备选择为什么你的程序总抓到虚拟摄像头2.1 枚举逻辑与设备索引的坑很多人第一次写 C# 摄像头代码直接new VideoCaptureDevice(0)就完事结果在装了虚拟摄像头、OBS 虚拟设备或者某些会议软件的机器上抓到的根本不是物理摄像头。这份测试源码里枚举部分不是简单拿个索引而是先把系统里所有视频输入设备列出来再按名称和单色/彩色能力做筛选。常见做法是用 DirectShow 的DsDevice.GetDevicesOfCat(FilterCategory.VideoInputDevice)拿到设备列表然后遍历。下面这段是测试源码里枚举部分的典型写法// 枚举所有视频输入设备并打印名称与单色能力 var devices DsDevice.GetDevicesOfCat(FilterCategory.VideoInputDevice); for (int i 0; i devices.Length; i) { var d devices[i]; // Moniker 是设备唯一标识比索引可靠 Console.WriteLine($[{i}] {d.Name}); Console.WriteLine($ Moniker: {d.MonikerString}); }逻辑说明GetDevicesOfCat返回的是系统当前注册的所有视频输入设备顺序不保证和物理接口顺序一致。参数上FilterCategory.VideoInputDevice是 DirectShow 里视频输入设备的固定分类不要改成VideoInputDevice之外的东西。关键点是不要用索引当设备 ID因为插拔一次 USB 或者重启一次索引就可能变。测试源码里把MonikerString打印出来就是为了让你在正式代码里用 Moniker 去绑定设备而不是用0、1这种数字。2.2 用 Moniker 绑定设备并做一次“能不能出图”的预检枚举出来之后测试源码会做一次预检尝试用选中的 Moniker 打开设备读一帧然后立刻释放。这一步能过滤掉“设备在列表里但已经被占用”的情况。// 用 Moniker 打开设备并尝试抓一帧确认设备真正可用 var moniker new Moniker(monikerString); var device new VideoCaptureDevice(moniker); try { device.Start(); // 等待一小段时间让第一帧到达具体毫秒数按摄像头启动速度调整 Thread.Sleep(300); if (device.IsRunning) { Console.WriteLine(设备可正常启动并出图); } device.SignalToStop(); device.WaitForStop(); } catch (Exception ex) { Console.WriteLine($设备打开失败: {ex.Message}); }逻辑说明Start()之后不要立刻判断很多 USB 摄像头需要 200 到 500 毫秒才能出第一帧所以这里Sleep(300)是个经验值不是标准。参数上SignalToStop()和WaitForStop()要成对出现否则设备可能没释放干净下一次打开就报“被占用”。这一步的坑在于有些摄像头在Start()之后不会抛异常但IsRunning是 false这种就是驱动层没起来换 USB 口或者换线比改代码有用。2.3 设备选择策略按名称匹配还是按能力匹配测试源码里给了一个简单的选择策略优先选名称里不含“virtual”“obs”“manycam”这类关键词的设备然后按分辨率能力排序。这个策略不完美但比直接取第一个强。如果你是在固定工控机上跑建议把 Moniker 写进配置文件启动时按 Moniker 精确匹配匹配不到再回退到名称模糊匹配。这样换设备时只需要改配置不用重新编译。3. 预览与抓拍从第一帧到保存图片的完整链路3.1 预览窗口的绑定与帧率控制预览部分测试源码用的是 WinForms 的PictureBox加NewFrame事件。核心不是“怎么显示”而是“怎么不卡死 UI 线程”。很多新手直接在NewFrame里做图像处理结果预览一卡一卡还以为是摄像头问题。// 绑定 NewFrame 事件在事件里只做最小化拷贝处理放到后台 device.NewFrame (sender, eventArgs) { var frame eventArgs.Frame; // 克隆一份避免原始帧被下一帧覆盖 var bmp (Bitmap)frame.Clone(); // 用 BeginInvoke 回到 UI 线程更新 PictureBox pictureBox1.BeginInvoke(new Action(() { var old pictureBox1.Image; pictureBox1.Image bmp; old?.Dispose(); // 及时释放上一帧防止内存涨 })); };逻辑说明NewFrame是在采集线程里触发的不能直接操作 UI 控件。Clone()是必须的因为eventArgs.Frame在事件返回后可能被复用。参数上BeginInvoke比Invoke好因为Invoke会阻塞采集线程帧率一高就丢帧。这里的关键坑是pictureBox1.Image旧图不释放跑几分钟内存就上去了工控机上直接卡死。3.2 抓拍保存格式、路径与文件名策略抓拍部分测试源码提供了两种方式一种是保存当前预览帧另一种是重新打开设备抓一帧高清图。前者快但分辨率受预览限制后者慢但能拿到摄像头支持的最高分辨率。// 保存当前帧为 JPG文件名带时间戳避免覆盖 var savePath Path.Combine(AppDomain.CurrentDomain.BaseDirectory, captures); Directory.CreateDirectory(savePath); var fileName $capture_{DateTime.Now:yyyyMMdd_HHmmss_fff}.jpg; var fullPath Path.Combine(savePath, fileName); bmp.Save(fullPath, ImageFormat.Jpeg); Console.WriteLine($已保存: {fullPath});逻辑说明AppDomain.CurrentDomain.BaseDirectory是程序运行目录比Application.StartupPath更通用。文件名用yyyyMMdd_HHmmss_fff精确到毫秒防止连续抓拍时覆盖。参数上ImageFormat.Jpeg是有损压缩如果要做后续图像分析建议改成Png或者Bmp。这里有个血泪经验工控机上系统时间可能被改用时间戳做文件名会出现重复最好再加一个自增序号。3.3 分辨率与帧率参数怎么设才不翻车测试源码里把分辨率设置放在设备启动之前而不是启动之后。顺序错了有些摄像头会直接忽略你的设置。// 先设置分辨率再 Start顺序不能反 device.VideoResolution device.VideoCapabilities .FirstOrDefault(c c.FrameSize.Width 1920 c.FrameSize.Height 1080) ?? device.VideoCapabilities[0]; device.Start();逻辑说明VideoCapabilities是设备支持的分辨率列表不是所有摄像头都支持 1920x1080。如果FirstOrDefault返回 null就回退到第一个可用分辨率。参数上帧率一般通过device.DesiredFrameRate设置但注意这个属性不是所有驱动都认设了没效果是常态。常见做法是分辨率优先帧率随缘实在要稳帧率就上工业相机。4. 避坑与排查摄像头测试里最容易翻车的五个点4.1 现象程序启动就报“设备被占用” → 原因上一个进程没释放 → 解决加互斥或强制释放这是最高频的问题。测试源码里在打开设备前会先尝试SignalToStop并WaitForStop但如果是别的进程占着这招没用。解决方式是在程序启动时用Mutex做单实例或者用handle.exe查一下哪个进程占着摄像头。工控机上常见的是某个后台服务开机自启把摄像头锁了。4.2 现象预览有图像但抓拍是黑屏 → 原因抓拍时重新打开设备导致曝光未稳定 → 解决抓拍前丢弃前几帧有些摄像头从打开到曝光稳定需要几帧时间。测试源码里抓拍逻辑会先丢弃前 5 帧再保存。如果你自己写可以在NewFrame里加个计数器前 5 帧不处理。这个坑在低照度环境下特别明显预览看着正常抓下来一片黑。4.3 现象跑一段时间后内存暴涨 → 原因Bitmap 和 Frame 没释放 → 解决每帧 Dispose用 using 包住前面预览部分提过这里再强调一次。NewFrame里的Frame是托管的但Clone()出来的Bitmap必须手动Dispose。测试源码里在替换PictureBox.Image时会把旧图释放掉。如果你还在别的地方存了引用记得一起释放。工控机内存本来就紧张这个坑不处理跑一晚上必崩。4.4 现象换 USB 口后设备索引变了程序抓错设备 → 原因用索引绑定设备 → 解决改用 Moniker 或设备名称这个在第二章讲过但实际排查时很多人还是栽在这。测试源码里枚举部分打印 Moniker 就是为了让你复制到配置里。如果你用的是VideoCaptureDevice(0)换口之后0可能变成另一个设备。解决方式配置文件里存 Moniker启动时精确匹配匹配不到再报错让用户选。4.5 现象分辨率设了 1080P 但实际出图是 640x480 → 原因设置顺序错或驱动不支持 → 解决先查 VideoCapabilities 再设设完打印实际值测试源码里在Start()之后会打印device.VideoResolution.FrameSize确认实际生效的分辨率。如果和你设的不一样说明驱动没接受。常见做法是遍历VideoCapabilities找到最接近你目标的分辨率而不是硬写一个。有些摄像头只支持特定组合比如 1280x720 可以1920x1080 就不行。5. 进阶技巧把测试源码变成你的摄像头排错基线5.1 用命令行参数做无界面自检测试源码可以加一个--selftest参数启动后不显示窗口只枚举设备、尝试打开、抓一帧、保存到临时目录然后退出并返回退出码。这样你可以把它塞进产线开机脚本里每次开机自动跑一遍确认摄像头可用。// 简易自检模式无界面抓一帧存临时文件成功返回 0 if (args.Contains(--selftest)) { var dev DsDevice.GetDevicesOfCat(FilterCategory.VideoInputDevice).FirstOrDefault(); if (dev null) return 1; var cap new VideoCaptureDevice(dev.MonikerString); cap.Start(); Thread.Sleep(500); if (!cap.IsRunning) return 2; // 这里省略抓帧保存逻辑实际用 NewFrame 事件取一帧 cap.SignalToStop(); cap.WaitForStop(); return 0; }逻辑说明退出码 0 表示成功1 表示没设备2 表示设备打不开。参数上args.Contains需要using System.Linq;。这个自检模式的好处是不用人盯着脚本就能判断摄像头状态。我一般会把它和工控机的看门狗配合自检失败就重启相关服务。5.2 把设备信息导出成 JSON 方便比对测试源码里可以加一个导出功能把枚举到的设备名称、Moniker、支持的分辨率列表写成一个 JSON 文件。这样换机器或者换摄像头时直接 diff 两个 JSON就知道差异在哪。// 导出设备信息为 JSON方便比对 var info devices.Select(d new { d.Name, d.MonikerString, Resolutions new VideoCaptureDevice(d.MonikerString) .VideoCapabilities .Select(c ${c.FrameSize.Width}x{c.FrameSize.Height}) .Distinct() .ToList() }).ToList(); var json JsonConvert.SerializeObject(info, Formatting.Indented); File.WriteAllText(devices.json, json);逻辑说明JsonConvert需要 Newtonsoft.Json 包测试源码里如果没带可以用System.Text.Json替代。参数上Distinct()去重是因为有些摄像头会重复报告同一分辨率。这个 JSON 文件在排查“为什么这台机器上程序正常那台不正常”时特别有用。5.3 一个我自己的习惯每次换摄像头先跑三遍从那以后我每次换摄像头或者换工控机都强制走一遍第一遍跑自检模式确认退出码是 0第二遍跑预览模式看实际帧率和分辨率第三遍跑抓拍模式检查保存的图片是不是正常曝光。三遍都过了才把 Moniker 写进正式配置。这个习惯帮我省了很多“到现场才发现摄像头不认”的后悔药。希望帮到你。本文还有配套的精品资源点击获取