VisioForge

C#-Barcode-Scanner für .NET aus Live-Video

Lesen Sie QR-Codes und 1D-Barcodes in C# von einer Webcam, einer IP-Kamera, dem Bildschirm oder aus einer Videodatei. Der Barcode-Detektor ist ein Block in einer .NET-Video-Pipeline: Sie scannen dasselbe Video, das Sie anzeigen, aufzeichnen oder streamen, unter Windows, macOS, Linux, Android und iOS.

Ein Barcode-Scanner für Video, nicht für gescannte Dokumente

Media Blocks SDK .NET und Video Capture SDK .NET lesen Barcodes und QR-Codes aus Live-Video: Webcams, IP-Kameras über RTSP oder ONVIF, Bildschirmaufnahme und Videodateien. Der Detektor läuft in der Video-Pipeline und löst ein Ereignis mit Barcode-Typ und Wert aus, sobald er in einem Frame einen Code dekodiert. Er ist für Anwendungen gedacht, die ohnehin mit Video arbeiten, etwa Einlass- und Ticketkontrollen, Kameras in Lager und Produktion oder Kioske. Wenn Ihre Eingabe aus Standbildern, PDFs oder gescannten Dokumenten besteht, ist eine Barcode-Bibliothek für Bilder die bessere Wahl.

Barcode-Scan in den beiden SDKs

Media Blocks SDK .NETVideo Capture SDK .NET
APIBarcodeDetectorBlock in einer MediaBlocksPipeline; das Ereignis OnBarcodeDetected liefert Barcode-Typ, Wert und ZeitstempelVideoCaptureCoreX und VideoCaptureCore: Barcode_Reader_Enabled setzen und OnBarcodeDetected behandeln; VideoCaptureCore nimmt zusätzlich Barcode_Reader_Type
Barcode-TypenQR Code, EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF und GS1 DataBar (RSS-14), wobei UPC-A und UPC-E als EAN-13 gemeldet werden; Data Matrix mit DataMatrixDecoderBlockVideoCaptureCoreX: dieselben Typen wie BarcodeDetectorBlock. VideoCaptureCore: QR Code, Data Matrix, PDF417, Aztec, EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF und RSS-14
VideoquellenJeder Block mit Videoausgang: Webcams und Aufnahmegeräte, IP-Kameras über RTSP und ONVIF, Bildschirmaufnahme, Videodateien und NetzwerkstreamsDie Aufnahmequellen der Engine: Webcams und Aufnahmegeräte, IP-Kameras über RTSP und ONVIF, Bildschirmaufnahme
PlattformenWindows, macOS, Linux, Android und iOSVideoCaptureCoreX: Windows, macOS, Linux, Android und iOS. VideoCaptureCore: Windows
EditionEine Edition mit allen Blöcken, der Barcode-Detektor eingeschlossenDer Barcode-Leser ist in jeder Edition enthalten, auch in Standard; IP-Kameraquellen erfordern Professional oder Premium

So arbeitet der Scanner

BarcodeDetectorBlock kapselt den Barcode-Detektor zbar. Er liest jeden Video-Frame, der ihn durchläuft, und meldet die gefundenen Codes.

  • OnBarcodeDetected liefert den Barcode-Typ, den dekodierten Wert und den Zeitstempel des Frames auf der Zeitachse der Pipeline; UPC-A- und UPC-E-Codes werden als EAN-13 gemeldet
  • Der Modus InputOutput gibt das Video an eine Vorschau, einen Encoder oder einen Stream weiter; der Modus InputOnly scannt nur, für Dienste ohne Bildschirm
  • Der Scan läuft in derselben Pipeline wie Vorschau, Aufnahme und Streaming, sodass ein Kamerabild gleichzeitig aufgezeichnet und gescannt werden kann
  • Ein Code, der im Bild bleibt, wird in den folgenden Frames erneut gemeldet; filtern Sie Wiederholungen im Handler nach dem Wert
  • BarcodeDetectorBlock.IsAvailable() zeigt vor dem Aufbau der Pipeline, ob der Detektor auf diesem Rechner laufen kann
  • Data-Matrix-Codes liest ein eigener Block, DataMatrixDecoderBlock, auf Basis von libdmtx

Einsatzbereiche

Ticket- und Zutrittskontrolle

QR-Codes auf Tickets und Ausweisen am Eingang mit einer Webcam oder Tablet-Kamera prüfen und dem Personal das Livebild zeigen.

Lager und Produktionslinien

Barcodes auf Paketen und Teilen von fest montierten IP-Kameras über RTSP lesen, während derselbe Stream für die spätere Prüfung aufgezeichnet wird.

Kioske und Self-Service-Terminals

Einen auf dem Smartphone angezeigten QR-Code in einer WPF-, WinUI-3-, MAUI- oder Avalonia-Anwendung scannen.

Aufgezeichnete Videos und Bildschirme

Die Barcodes in einer Videodatei finden oder auf dem Desktop angezeigte QR-Codes per Bildschirmaufnahme lesen.

Codebeispiele

Das erste Beispiel scannt eine RTSP-Kamera mit Media Blocks SDK .NET; das zweite schaltet den Barcode-Leser der Aufnahme-Engine von Video Capture SDK .NET ein.

Barcodes und QR-Codes von einer RTSP-Kamera scannen

C#

Den Barcode-Leser einer Webcam-Aufnahme einschalten

C#

Wo der Detektor sitzt

Der Detektor ist ein Block in der Pipeline. Das Video läuft durch ihn hindurch zum Rest der Pipeline, und jeder dekodierte Code kommt als Ereignis an.

Webcam, IP-Kamera, Bildschirm oder Datei
BarcodeDetectorBlock
Vorschau, Aufnahme oder Stream

Häufig gestellte Fragen

Wie scanne ich in C# Barcodes von einer Webcam?▼
Mit Media Blocks SDK .NET erstellen Sie eine MediaBlocksPipeline, holen die Kamera über DeviceEnumerator.Shared.VideoSourcesAsync() und verbinden einen SystemVideoSourceBlock mit einem BarcodeDetectorBlock im Modus InputOutput und danach mit einem VideoRendererBlock für die Vorschau. Behandeln Sie OnBarcodeDetected, um jeden Code zu erhalten. Mit Video Capture SDK .NET setzen Sie Barcode_Reader_Enabled bei VideoCaptureCoreX auf true und behandeln dasselbe Ereignis.
Kann ich QR-Codes von einer IP-Kamera oder einem RTSP-Stream lesen?▼
Ja. Erstellen Sie die Quelle mit RTSPSourceSettings.CreateAsync und RTSPSourceBlock oder mit UniversalSourceBlock und der rtsp://-Adresse und verbinden Sie ihren Videoausgang mit BarcodeDetectorBlock. ONVIF-Kameras werden über ihren RTSP-Stream gelesen.
Kann ich ihn in ASP.NET oder einem serverseitigen Dienst verwenden?▼
Ja. BarcodeDetectorBlock braucht kein Fenster: Im Modus InputOnly scannt er ohne Wiedergabe und läuft daher in einer Konsolenanwendung, einem Windows-Dienst oder einem Hintergrunddienst einer ASP.NET-Core-Anwendung, unter Windows oder Linux. Er liest das Video, das der Server selbst öffnen kann, etwa IP-Kamerastreams, Videodateien und am Server angeschlossene Aufnahmegeräte. Die Kamera im Browser eines Besuchers nimmt er nicht auf.
Welche Barcode-Typen werden gelesen?▼
BarcodeDetectorBlock und VideoCaptureCoreX lesen QR Code, EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF (Interleaved 2 of 5) und GS1 DataBar (RSS-14). Beide melden UPC-A und UPC-E als EAN-13: Ein UPC-A-Wert kommt als 13 Ziffern mit führender 0 an, ein UPC-E-Wert in seine 13-stellige Form erweitert. Data Matrix liest DataMatrixDecoderBlock. Die Windows-Engine VideoCaptureCore liest zusätzlich Data Matrix, PDF417 und Aztec, und ihre Eigenschaft Barcode_Reader_Type wählt einen Typ oder alle; im Standardmodus Auto meldet das Ereignis den Typ als Auto.
Funktioniert das unter Linux, macOS, Android und iOS?▼
Ja. BarcodeDetectorBlock und VideoCaptureCoreX laufen unter Windows, macOS, Linux, Android und iOS; VideoCaptureCore nur unter Windows. Unter Windows, macOS, Android und iOS ist der Detektor in den NuGet-Paketen VisioForge.CrossPlatform.Core.* enthalten. Unter Linux nutzt das SDK das GStreamer des Systems; prüfen Sie daher mit BarcodeDetectorBlock.IsAvailable(), ob der Detektor installiert ist. Apps für Android, iOS und macOS brauchen außerdem die Kameraberechtigung.
Erhalte ich denselben Barcode mehrmals?▼
Ja. Der Detektor meldet einen Code in jedem Frame, in dem er ihn dekodiert, daher kommt ein vor die Kamera gehaltener Code viele Male an. Merken Sie sich im Handler den letzten Wert und die Zeit und überspringen Sie Wiederholungen innerhalb eines kurzen Zeitfensters, wie es der Barcode-Leitfaden zeigt.
Welche Lizenz brauche ich?▼
Media Blocks SDK .NET hat eine Edition, und der Barcode-Detektor gehört dazu. In Video Capture SDK .NET ist der Barcode-Leser in jeder Edition enthalten, auch in Standard; IP-Kameraquellen erfordern die Edition Professional oder Premium. Eine Lizenz von Video Capture SDK .NET deckt beide Engines ab, VideoCaptureCore und VideoCaptureCoreX. Die Preise sind in Euro, die Mehrwertsteuer wird an der Kasse hinzugefügt, wo sie anfällt. Die 30-Tage-Testversion ist voll funktionsfähig.

Barcodes aus Video in C# scannen

Laden Sie die voll funktionsfähige 30-Tage-Testversion herunter und starten Sie die Barcode-Beispiele. Je nach Ausgabe kann ein Wasserzeichen oder ein Hinweis auf die nicht registrierte Version erscheinen.

Welches SDK und welche Edition

Die Preise sind in Euro; die Mehrwertsteuer wird an der Kasse hinzugefügt, wo sie anfällt. Eine Lizenz deckt beide Engines von Video Capture SDK .NET ab.