VisioForge

Scanner di codici a barre C# per .NET da video live

Leggi codici QR e codici a barre 1D in C# da una webcam, una telecamera IP, lo schermo o un file video. Il rilevatore di codici a barre è un blocco di una pipeline video .NET: scansioni lo stesso video che mostri, registri o trasmetti, su Windows, macOS, Linux, Android e iOS.

Uno scanner di codici a barre per il video, non per documenti scansionati

Media Blocks SDK .NET e Video Capture SDK .NET leggono codici a barre e codici QR dal video live: webcam, telecamere IP via RTSP o ONVIF, cattura dello schermo e file video. Il rilevatore gira nella pipeline video e genera un evento con il tipo e il valore del codice ogni volta che decodifica un codice in un fotogramma. È pensato per applicazioni che lavorano già con il video, come controllo di biglietti e accessi, telecamere di magazzino e di linea di produzione o chioschi. Se i tuoi input sono immagini statiche, PDF o documenti scansionati, una libreria di codici a barre per immagini è la scelta più adatta.

La scansione dei codici a barre nei due SDK

Media Blocks SDK .NETVideo Capture SDK .NET
APIBarcodeDetectorBlock in una MediaBlocksPipeline; l'evento OnBarcodeDetected fornisce tipo, valore e timestamp del codiceVideoCaptureCoreX e VideoCaptureCore: imposta Barcode_Reader_Enabled e gestisci OnBarcodeDetected; VideoCaptureCore accetta anche Barcode_Reader_Type
Tipi di codiceQR Code, EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF e GS1 DataBar (RSS-14), con UPC-A e UPC-E segnalati come EAN-13; Data Matrix con DataMatrixDecoderBlockVideoCaptureCoreX: gli stessi tipi di BarcodeDetectorBlock. VideoCaptureCore: QR Code, Data Matrix, PDF417, Aztec, EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF e RSS-14
Sorgenti videoQualsiasi blocco con un'uscita video: webcam e dispositivi di acquisizione, telecamere IP via RTSP e ONVIF, cattura dello schermo, file video e stream di reteLe sorgenti di acquisizione del motore: webcam e dispositivi di acquisizione, telecamere IP via RTSP e ONVIF, cattura dello schermo
PiattaformeWindows, macOS, Linux, Android e iOSVideoCaptureCoreX: Windows, macOS, Linux, Android e iOS. VideoCaptureCore: Windows
EdizioneUn'unica edizione con tutti i blocchi, rilevatore di codici a barre compresoIl lettore di codici a barre è in ogni edizione, Standard compresa; le sorgenti da telecamera IP richiedono Professional o Premium

Come funziona lo scanner

BarcodeDetectorBlock incapsula il rilevatore di codici a barre zbar. Legge ogni fotogramma video che lo attraversa e segnala i codici che trova.

  • OnBarcodeDetected fornisce il tipo di codice, il valore decodificato e il timestamp del fotogramma sulla timeline della pipeline; i codici UPC-A e UPC-E vengono segnalati come EAN-13
  • La modalità InputOutput passa il video a un'anteprima, un encoder o uno stream; la modalità InputOnly esegue solo la scansione, per servizi senza schermo
  • La scansione gira nella stessa pipeline di anteprima, registrazione e streaming, quindi l'immagine di una telecamera può essere registrata e scansionata insieme
  • Un codice che resta inquadrato viene segnalato di nuovo nei fotogrammi successivi: filtra le ripetizioni per valore nel tuo handler
  • BarcodeDetectorBlock.IsAvailable() indica, prima di costruire la pipeline, se il rilevatore può funzionare su questa macchina
  • I codici Data Matrix li legge un blocco separato, DataMatrixDecoderBlock, basato su libdmtx

Dove si usa

Controllo biglietti e accessi

Verifica i codici QR di biglietti e pass a un ingresso con una webcam o la fotocamera di un tablet, e mostra l'immagine live all'operatore.

Magazzini e linee di produzione

Leggi i codici a barre di pacchi e componenti da telecamere IP fisse via RTSP mentre lo stesso stream viene registrato per un controllo successivo.

Chioschi e terminali self-service

Scansiona un codice QR mostrato sullo schermo di un telefono in un'applicazione WPF, WinUI 3, MAUI o Avalonia.

Video registrati e schermi

Trova i codici a barre in un file video, oppure leggi i codici QR mostrati sul desktop con la cattura dello schermo.

Esempi di codice

Il primo esempio scansiona una telecamera RTSP con Media Blocks SDK .NET; il secondo attiva il lettore di codici a barre del motore di acquisizione di Video Capture SDK .NET.

Scansionare codici a barre e QR da una telecamera RTSP

C#

Attivare il lettore di codici a barre in un'acquisizione da webcam

C#

Dove si trova il rilevatore

Il rilevatore è un blocco della pipeline. Il video lo attraversa verso il resto della pipeline, e ogni codice decodificato arriva come evento.

Webcam, telecamera IP, schermo o file
BarcodeDetectorBlock
Anteprima, registrazione o stream

Domande frequenti

Come scansiono codici a barre da una webcam in C#?▼
Con Media Blocks SDK .NET crea una MediaBlocksPipeline, ottieni la telecamera da DeviceEnumerator.Shared.VideoSourcesAsync() e collega un SystemVideoSourceBlock a un BarcodeDetectorBlock in modalità InputOutput e poi a un VideoRendererBlock per l'anteprima. Gestisci OnBarcodeDetected per ricevere ogni codice. Con Video Capture SDK .NET imposta Barcode_Reader_Enabled a true su VideoCaptureCoreX e gestisci lo stesso evento.
Posso leggere codici QR da una telecamera IP o da uno stream RTSP?▼
Sì. Crea la sorgente con RTSPSourceSettings.CreateAsync e RTSPSourceBlock, oppure con UniversalSourceBlock e l'indirizzo rtsp://, e collega la sua uscita video a BarcodeDetectorBlock. Le telecamere ONVIF si leggono tramite il loro stream RTSP.
Posso usarlo in ASP.NET o in un servizio lato server?▼
Sì. BarcodeDetectorBlock non ha bisogno di una finestra: in modalità InputOnly scansiona senza mostrare il video, quindi funziona in un'applicazione console, in un servizio Windows o in un servizio in background di un'applicazione ASP.NET Core, su Windows o Linux. Legge il video che il server stesso può aprire, come stream di telecamere IP, file video e dispositivi di acquisizione collegati al server. Non acquisisce la fotocamera del browser di un visitatore.
Quali tipi di codici a barre legge?▼
BarcodeDetectorBlock e VideoCaptureCoreX leggono QR Code, EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93, Codabar, ITF (Interleaved 2 of 5) e GS1 DataBar (RSS-14). Entrambi segnalano UPC-A e UPC-E come EAN-13: un valore UPC-A arriva come 13 cifre con uno 0 iniziale, e un valore UPC-E arriva espanso nella sua forma a 13 cifre. Data Matrix lo legge DataMatrixDecoderBlock. Il motore Windows VideoCaptureCore legge anche Data Matrix, PDF417 e Aztec, e la sua proprietà Barcode_Reader_Type seleziona un tipo o tutti; nella modalità Auto predefinita l'evento riporta il tipo come Auto.
Funziona su Linux, macOS, Android e iOS?▼
Sì. BarcodeDetectorBlock e VideoCaptureCoreX funzionano su Windows, macOS, Linux, Android e iOS; VideoCaptureCore solo su Windows. Su Windows, macOS, Android e iOS il rilevatore è incluso nei pacchetti NuGet VisioForge.CrossPlatform.Core.*. Su Linux l'SDK usa il GStreamer di sistema, quindi chiama BarcodeDetectorBlock.IsAvailable() per verificare che il rilevatore sia installato. Le app Android, iOS e macOS richiedono anche il permesso per la fotocamera.
Ricevo lo stesso codice a barre più di una volta?▼
Sì. Il rilevatore segnala un codice in ogni fotogramma in cui lo decodifica, quindi un codice tenuto davanti alla telecamera arriva molte volte. Conserva l'ultimo valore e l'ora nel tuo handler e salta le ripetizioni entro un breve intervallo, come mostra la guida ai codici a barre.
Quale licenza mi serve?▼
Media Blocks SDK .NET ha un'unica edizione, e il rilevatore di codici a barre ne fa parte. In Video Capture SDK .NET il lettore di codici a barre è incluso in ogni edizione, Standard compresa; le sorgenti da telecamera IP richiedono l'edizione Professional o Premium. Una licenza di Video Capture SDK .NET copre entrambi i motori, VideoCaptureCore e VideoCaptureCoreX. I prezzi sono in euro, e l'IVA viene aggiunta al pagamento dove si applica. La prova di 30 giorni è completamente funzionante.

Inizia a scansionare codici a barre dal video in C#

Scarica la prova di 30 giorni completamente funzionante ed esegui gli esempi sui codici a barre. A seconda dell'uscita può comparire una filigrana o un avviso di versione non registrata.

Quale SDK e quale edizione

I prezzi sono in euro; l'IVA viene aggiunta al pagamento dove si applica. Una licenza copre entrambi i motori di Video Capture SDK .NET.