VisioForge

从实时视频读取条码的 .NET C# 条码扫描器

用 C# 从网络摄像头、IP 摄像机、屏幕或视频文件读取二维码和一维条码。条码检测器是 .NET 视频管道中的一个块,因此你可以直接扫描正在预览、录制或推流的视频,支持 Windows、macOS、Linux、Android 和 iOS。

每年 €500 起 · Lifetime 许可证 €1,800 起

面向视频的条码扫描器,而不是面向扫描文档

Media Blocks SDK .NET 和 Video Capture SDK .NET 从实时视频读取条码和二维码:网络摄像头、通过 RTSP 或 ONVIF 连接的 IP 摄像机、屏幕捕获和视频文件。检测器在视频管道中运行,每当在某一帧中解码出条码时,就会触发一个包含条码类型和值的事件。它面向本来就处理视频的应用,例如入口和门票核验、仓库和生产线摄像机、自助终端。如果你的输入是静态图片、PDF 或扫描文档,更适合使用面向图片的条码库。

两款 SDK 中的条码扫描

Media Blocks SDK .NETVideo Capture SDK .NET
APIMediaBlocksPipeline 中的 BarcodeDetectorBlock;OnBarcodeDetected 事件提供条码类型、值和时间戳VideoCaptureCoreX 和 VideoCaptureCore:设置 Barcode_Reader_Enabled 并处理 OnBarcodeDetected;VideoCaptureCore 还支持 Barcode_Reader_Type
条码类型QR Code、EAN-13、EAN-8、UPC-A、UPC-E、Code 128、Code 39、Code 93、Codabar、ITF 和 GS1 DataBar (RSS-14),其中 UPC-A 和 UPC-E 以 EAN-13 报告;Data Matrix 由 DataMatrixDecoderBlock 读取VideoCaptureCoreX:与 BarcodeDetectorBlock 相同的类型。VideoCaptureCore:QR Code、Data Matrix、PDF417、Aztec、EAN-13、EAN-8、UPC-A、UPC-E、Code 128、Code 39、Code 93、Codabar、ITF 和 RSS-14
视频源任何带视频输出的块:网络摄像头和采集设备、通过 RTSP 和 ONVIF 连接的 IP 摄像机、屏幕捕获、视频文件和网络流引擎的采集源:网络摄像头和采集设备、通过 RTSP 和 ONVIF 连接的 IP 摄像机、屏幕捕获
平台Windows、macOS、Linux、Android 和 iOSVideoCaptureCoreX:Windows、macOS、Linux、Android 和 iOS。VideoCaptureCore:Windows
版本只有一个版本,包含所有块,条码检测器也在其中所有版本都包含条码读取器,包括 Standard;IP 摄像机源需要 Professional 或 Premium

扫描器的工作方式

BarcodeDetectorBlock 封装了条码检测器 zbar。它读取经过它的每一帧视频,并报告找到的条码。

  • OnBarcodeDetected 提供条码类型、解码后的值,以及该帧在管道时间轴上的时间戳;UPC-A 和 UPC-E 码以 EAN-13 报告
  • InputOutput 模式把视频继续传给预览、编码器或推流;InputOnly 模式只做扫描,适合没有屏幕的服务
  • 扫描与预览、录制和推流在同一个管道中运行,因此同一路摄像机画面可以一边录制一边扫描
  • 一直留在画面中的条码会在后续帧中再次报告,请在处理程序中按值过滤重复结果
  • BarcodeDetectorBlock.IsAvailable() 可以在构建管道之前告诉你检测器能否在这台机器上运行
  • Data Matrix 码由另一个基于 libdmtx 的块 DataMatrixDecoderBlock 读取

应用场景

门票与门禁核验

在入口用网络摄像头或平板电脑摄像头核验门票和通行证上的二维码,并向工作人员显示实时画面。

仓库与生产线

通过 RTSP 从固定安装的 IP 摄像机读取包裹和零件上的条码,同时把同一路流录制下来供日后检查。

自助终端

在 WPF、WinUI 3、MAUI 或 Avalonia 应用中扫描手机屏幕上显示的二维码。

录制的视频与屏幕

在视频文件中查找条码,或通过屏幕捕获读取桌面上显示的二维码。

代码示例

第一个示例用 Media Blocks SDK .NET 扫描 RTSP 摄像机;第二个示例开启 Video Capture SDK .NET 采集引擎的条码读取器。

从 RTSP 摄像机扫描条码和二维码

C#

在网络摄像头采集中开启条码读取器

C#

检测器所在的位置

检测器是管道中的一个块。视频经过它流向管道的其余部分,每个解码出的条码都以事件形式送达。

网络摄像头、IP 摄像机、屏幕或文件
BarcodeDetectorBlock
预览、录制或推流

常见问题

如何在 C# 中从网络摄像头扫描条码?▼
使用 Media Blocks SDK .NET 时,创建 MediaBlocksPipeline,通过 DeviceEnumerator.Shared.VideoSourcesAsync() 获取摄像头,把 SystemVideoSourceBlock 连接到 InputOutput 模式的 BarcodeDetectorBlock,再连接到用于预览的 VideoRendererBlock。处理 OnBarcodeDetected 即可逐个收到条码。使用 Video Capture SDK .NET 时,把 VideoCaptureCoreX 的 Barcode_Reader_Enabled 设为 true,并处理同一个事件。
能从 IP 摄像机或 RTSP 流读取二维码吗?▼
能。用 RTSPSourceSettings.CreateAsync 和 RTSPSourceBlock,或用 UniversalSourceBlock 加 rtsp:// 地址创建源,再把它的视频输出连接到 BarcodeDetectorBlock。ONVIF 摄像机通过其 RTSP 流读取。
能在 ASP.NET 或服务器端服务中使用吗?▼
能。BarcodeDetectorBlock 不需要窗口:在 InputOnly 模式下它扫描时不显示视频,因此可以在控制台应用、Windows 服务或 ASP.NET Core 应用的后台服务中运行,适用于 Windows 或 Linux。它读取服务器自身能打开的视频,例如 IP 摄像机流、视频文件和连接到服务器的采集设备。它不会采集访问者浏览器中的摄像头。
支持哪些条码类型?▼
BarcodeDetectorBlock 和 VideoCaptureCoreX 读取 QR Code、EAN-13、EAN-8、UPC-A、UPC-E、Code 128、Code 39、Code 93、Codabar、ITF (Interleaved 2 of 5) 和 GS1 DataBar (RSS-14)。两者都把 UPC-A 和 UPC-E 报告为 EAN-13:UPC-A 的值以带前导 0 的 13 位数字到达,UPC-E 的值展开为 13 位形式到达。Data Matrix 由 DataMatrixDecoderBlock 读取。Windows 引擎 VideoCaptureCore 还能读取 Data Matrix、PDF417 和 Aztec,并通过 Barcode_Reader_Type 属性选择一种类型或全部类型;在默认的 Auto 模式下,事件报告的类型为 Auto。
能在 Linux、macOS、Android 和 iOS 上运行吗?▼
能。BarcodeDetectorBlock 和 VideoCaptureCoreX 可在 Windows、macOS、Linux、Android 和 iOS 上运行;VideoCaptureCore 仅支持 Windows。在 Windows、macOS、Android 和 iOS 上,检测器包含在 VisioForge.CrossPlatform.Core.* NuGet 包中。在 Linux 上,SDK 使用系统的 GStreamer,因此请调用 BarcodeDetectorBlock.IsAvailable() 检查检测器是否已安装。Android、iOS 和 macOS 应用还需要摄像头权限。
同一个条码会收到多次吗?▼
会。检测器在每一个解码出该条码的帧中都会报告,因此举在摄像头前的条码会多次到达。请在处理程序中记下上一次的值和时间,并跳过短时间窗口内的重复结果,条码指南中有相应做法。
需要哪种许可证?▼
Media Blocks SDK .NET 只有一个版本,条码检测器包含在其中。在 Video Capture SDK .NET 中,所有版本都包含条码读取器,包括 Standard;IP 摄像机源需要 Professional 或 Premium 版本。一个 Video Capture SDK .NET 许可证同时涵盖 VideoCaptureCore 和 VideoCaptureCoreX 两个引擎。价格以欧元计,适用时在结账时加收增值税。30 天试用版功能完整。