Crie um leitor de código de barras usando webcam em C#

Uma webcam pode substituir um leitor de código de barras dedicado?

Absolutamente. Qualquer webcam padrão ou dispositivo de captura de vídeo USB conectado a um computador Windows, macOS ou Linux pode funcionar como um leitor de código de barras quando combinado com o software correto. O processo funciona capturando quadros de vídeo da câmera, convertendo cada quadro em uma imagem bitmap e, em seguida, passando essa imagem para uma biblioteca de leitura de código de barras para decodificação.

As configurações tradicionais de leitura de código de barras que envolvem ferramentas como o SDK Dynamsoft Barcode Reader ou o DirectShow .NET geralmente exigem que você configure manualmente um gráfico de filtros, configure um gráfico de captura e conecte um pipeline de retorno de chamada de quadros apenas para obter quadros da câmera. O IronBarcode simplifica isso drasticamente, não há necessidade de construir uma infraestrutura complexa de transmissão de vídeo. Você fornece os dados da imagem e a classe BarcodeReader cuida do resto, suportando desde códigos de barras padrão até códigos QR a partir de um único método de leitura .

Como configurar a câmera e instalar as dependências?

Para obter quadros de vídeo de uma webcam e exibi-los em um aplicativo de console .NET , é necessário utilizar uma biblioteca de acesso à câmera. OpenCvSharp4 é um wrapper .NET leve e multiplataforma para OpenCV que simplifica bastante esse processo. Em conjunto com o IronBarcode, ele oferece tudo o que você precisa para criar um leitor de código de barras em tempo real sem se preocupar com a enumeração de dispositivos de captura de vídeo de baixo nível ou com a configuração da taxa de quadros.

Instale ambos os pacotes via NuGet:

dotnet add package OpenCvSharp4.Windows
dotnet add package OpenCvSharp4.Extensions
dotnet add package BarCode

dotnet add package OpenCvSharp4.Windows
dotnet add package OpenCvSharp4.Extensions
dotnet add package BarCode

```
dotnet add package OpenCvSharp4.Windows
dotnet add package OpenCvSharp4.Extensions
dotnet add package BarCode
```

Com esses três pacotes instalados, seu projeto obtém acesso à câmera através do OpenCvSharp e decodificação de código de barras através do IronBarcode. Sem dependências de sistema adicionais ou SDKs externos para configurar, basta instalar e usar.

Como capturar quadros de vídeo e ler dados de códigos de barras em tempo real?

O exemplo de código a seguir cria um leitor de código de barras baseado em console no Visual Studio que abre sua webcam padrão, captura quadros continuamente e lê cada um deles em busca de códigos de barras. Quando um código de barras é detectado, os dados são gravados no console e o quadro é salvo como um instantâneo.

using OpenCvSharp;
using OpenCvSharp.Extensions;
using IronBarCode;
using IronSoftware.Drawing;
// Open the default camera (device index 0)
using var capture = new VideoCapture(0);
if (!capture.IsOpened())
{
    Console.WriteLine("No camera found. Check connected devices.");
    return;
}
// Configure the barcode reader for real-time scanning
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.All,
    Speed = ReadingSpeed.Faster
};
Console.WriteLine("Barcode scanner active. Press 'Q' to quit.");
using var frame = new Mat();
bool scanning = true;
while (scanning)
{
    capture.Read(frame);
    if (frame.Empty())
        continue;
    // Convert the captured frame to a bitmap for barcode processing
    var bitmap = BitmapConverter.ToBitmap(frame);
    var anyBitmap = new AnyBitmap(bitmap);
    // Scan the frame for barcodes
    var results = BarcodeReader.Read(anyBitmap, options);
    foreach (var result in results)
    {
        Console.WriteLine($"Barcode detected: {result.Value}");
        Console.WriteLine($"  Format: {result.BarcodeType}");
        // Save a snapshot of the frame where the barcode was found
        bitmap.Save("barcode_snapshot.png");
        Console.WriteLine("  Snapshot saved to barcode_snapshot.png");
    }
    // Check for quit key
    if (Cv2.WaitKey(1) == 'q')
        scanning = false;
}
Console.WriteLine("Scanner stopped.");

using OpenCvSharp;
using OpenCvSharp.Extensions;
using IronBarCode;
using IronSoftware.Drawing;
// Open the default camera (device index 0)
using var capture = new VideoCapture(0);
if (!capture.IsOpened())
{
    Console.WriteLine("No camera found. Check connected devices.");
    return;
}
// Configure the barcode reader for real-time scanning
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = false,
    ExpectBarcodeTypes = BarcodeEncoding.All,
    Speed = ReadingSpeed.Faster
};
Console.WriteLine("Barcode scanner active. Press 'Q' to quit.");
using var frame = new Mat();
bool scanning = true;
while (scanning)
{
    capture.Read(frame);
    if (frame.Empty())
        continue;
    // Convert the captured frame to a bitmap for barcode processing
    var bitmap = BitmapConverter.ToBitmap(frame);
    var anyBitmap = new AnyBitmap(bitmap);
    // Scan the frame for barcodes
    var results = BarcodeReader.Read(anyBitmap, options);
    foreach (var result in results)
    {
        Console.WriteLine($"Barcode detected: {result.Value}");
        Console.WriteLine($"  Format: {result.BarcodeType}");
        // Save a snapshot of the frame where the barcode was found
        bitmap.Save("barcode_snapshot.png");
        Console.WriteLine("  Snapshot saved to barcode_snapshot.png");
    }
    // Check for quit key
    if (Cv2.WaitKey(1) == 'q')
        scanning = false;
}
Console.WriteLine("Scanner stopped.");

Imports OpenCvSharp
Imports OpenCvSharp.Extensions
Imports IronBarCode
Imports IronSoftware.Drawing

' Open the default camera (device index 0)
Using capture As New VideoCapture(0)
    If Not capture.IsOpened() Then
        Console.WriteLine("No camera found. Check connected devices.")
        Return
    End If

    ' Configure the barcode reader for real-time scanning
    Dim options As New BarcodeReaderOptions With {
        .ExpectMultipleBarcodes = False,
        .ExpectBarcodeTypes = BarcodeEncoding.All,
        .Speed = ReadingSpeed.Faster
    }
    Console.WriteLine("Barcode scanner active. Press 'Q' to quit.")

    Using frame As New Mat()
        Dim scanning As Boolean = True
        While scanning
            capture.Read(frame)
            If frame.Empty() Then
                Continue While
            End If

            ' Convert the captured frame to a bitmap for barcode processing
            Dim bitmap = BitmapConverter.ToBitmap(frame)
            Dim anyBitmap As New AnyBitmap(bitmap)

            ' Scan the frame for barcodes
            Dim results = BarcodeReader.Read(anyBitmap, options)
            For Each result In results
                Console.WriteLine($"Barcode detected: {result.Value}")
                Console.WriteLine($"  Format: {result.BarcodeType}")

                ' Save a snapshot of the frame where the barcode was found
                bitmap.Save("barcode_snapshot.png")
                Console.WriteLine("  Snapshot saved to barcode_snapshot.png")
            Next

            ' Check for quit key
            If Cv2.WaitKey(1) = AscW("q"c) Then
                scanning = False
            End If
        End While
    End Using
End Using

Console.WriteLine("Scanner stopped.")

Como ajustar o leitor de código de barras para diferentes casos de uso?

A leitura de códigos de barras no mundo real geralmente envolve condições imperfeitas, iluminação inadequada, ângulos distorcidos ou etiquetas danificadas. As opções de leitura da IronBarcode permitem equilibrar velocidade e precisão, dependendo do que você estiver utilizando.

using IronBarCode;
// Optimized options for scanning QR codes from a camera feed
var qrOptions = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.PDF417,
    Speed = ReadingSpeed.Detailed,
    AutoRotate = true
};
// Decode barcodes from a saved image captured by the webcam
var imageResults = BarcodeReader.Read("barcode_snapshot.png", qrOptions);
foreach (var barcode in imageResults)
{
    Console.WriteLine($"Data: {barcode.Value}");
    Console.WriteLine($"Type: {barcode.BarcodeType}");
    Console.WriteLine($"Page: {barcode.PageNumber}");
}

using IronBarCode;
// Optimized options for scanning QR codes from a camera feed
var qrOptions = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.PDF417,
    Speed = ReadingSpeed.Detailed,
    AutoRotate = true
};
// Decode barcodes from a saved image captured by the webcam
var imageResults = BarcodeReader.Read("barcode_snapshot.png", qrOptions);
foreach (var barcode in imageResults)
{
    Console.WriteLine($"Data: {barcode.Value}");
    Console.WriteLine($"Type: {barcode.BarcodeType}");
    Console.WriteLine($"Page: {barcode.PageNumber}");
}

Imports IronBarCode

' Optimized options for scanning QR codes from a camera feed
Dim qrOptions As New BarcodeReaderOptions With {
    .ExpectMultipleBarcodes = True,
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.PDF417,
    .Speed = ReadingSpeed.Detailed,
    .AutoRotate = True
}

' Decode barcodes from a saved image captured by the webcam
Dim imageResults = BarcodeReader.Read("barcode_snapshot.png", qrOptions)
For Each barcode In imageResults
    Console.WriteLine($"Data: {barcode.Value}")
    Console.WriteLine($"Type: {barcode.BarcodeType}")
    Console.WriteLine($"Page: {barcode.PageNumber}")
Next

O que torna essa abordagem mais simples do que as alternativas?

Muitos tutoriais de leitores de código de barras com webcam em C# dependem de combinações de várias bibliotecas, normalmente ZXing .NET para decodificação, juntamente com AForge .NET ou DirectShow .NET para acesso à câmera. Essa abordagem exige a configuração de um gráfico de filtros para captura de vídeo, a configuração manual de callbacks de quadros para extrair quadros do fluxo de vídeo e o tratamento da enumeração de dispositivos por meio de APIs de baixo nível do Windows. O SDK do leitor de código de barras da Dynamsoft segue um padrão semelhante, exigindo a implementação do DirectShow .NET para acessar a webcam.

O IronBarcode simplifica essa complexidade. A lógica de leitura de código de barras reside inteiramente em BarcodeReader.Read, que aceita um Bitmap, uma matriz de bytes, um caminho de arquivo ou um Stream. Não há necessidade de construir um gráfico de captura, nem de enviar objetos ou configurar eventos EventArgs para a captura de quadros; basta fornecer os dados da imagem e receber as informações do código de barras de volta. Isso significa menos código para escrever, menos dependências para manter e mais tempo dedicado aos recursos que realmente importam para sua aplicação.

Para equipes que desenvolvem em .NET Core, .NET Framework ou .NET 8+, o IronBarcode oferece suporte multiplataforma consistente em Windows, macOS, Linux, Docker, Azure e AWS. Explore o conjunto completo de funcionalidades ou navegue por exemplos de código adicionais para ver o que mais é possível.

Pronto para construir seu próprio leitor de código de barras?

Transformar uma webcam em um leitor de código de barras em C# requer um código mínimo quando você tem as ferramentas certas. O IronBarcode lida com a parte mais complexa da decodificação, desde códigos de barras padrão até códigos QR, enquanto o OpenCvSharp gerencia o acesso à câmera de forma eficiente. Juntos, eles criam um scanner fácil de construir, fácil de expandir e pronto para produção.

Inicie um teste gratuito para experimentar com seu próprio projeto ou explore as opções de licenciamento quando estiver pronto para implantar.