Como ler um QR Code de uma imagem em C#

Principais características

• Leia e gere códigos QR com facilidade.
• Suporte para JPEG, PNG, BMP e outros formatos de imagem.
• Alto desempenho e detecção precisa para fácil extração de dados de códigos QR.
• Funciona em projetos .NET Framework, .NET Core, .NET Standard (2.0+), e .NET 6/7+.
• Oferece suporte multiplataforma, para que você possa trabalhar no ambiente de aplicativo e sistema operacional de sua preferência, seja Windows, Linux, ou qualquer outro ambiente suportado.

Ao contrário das alternativas de código aberto, o IronQR foca na estabilidade de nível empresarial, licenciamento comercial e suporte profissional — o que o torna um excelente ajuste para aplicações críticas de negócios.

Instale via NuGet.

Você pode instalar o IronQR diretamente do NuGet Package Manager Console:

Install-Package IronQR

Install-Package IronQR

Alternativamente, use a interface gráfica do NuGet no Visual Studio buscando por IronQR, e clique em "Install":

Adicionar Namespaces e Configuração Básica

Assim que instalado, inclua o seguinte namespace em seu arquivo C#:

using IronSoftware.Drawing;
using IronQR;

using IronSoftware.Drawing;
using IronQR;

Nota: IronSoftware.Drawing é usado para manipular formatos de imagem de maneira multiplataforma.

Formatos de imagem suportados

O IronQR suporta vários tipos de formatos de imagem, incluindo:

• PNG
• JPG/JPEG
• BMP
• GIF
• TIFF

Essa flexibilidade permite que você trabalhe com praticamente qualquer fonte de imagem, desde fotos de câmera até documentos escaneados.

Exemplo de código básico

Vamos dar uma olhada mais de perto em como você pode usar essa biblioteca para decodificar códigos QR com facilidade. Aqui está um exemplo mínimo que lê um único código QR com o valor de texto "Hello World!" de um arquivo de imagem, usando a classe Bitmap e um fluxo de arquivo para carregar a imagem:

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image using a file stream
        using var stream = File.OpenRead("sample-qr.png");
        var bitmapImage = AnyBitmap.FromStream(stream);
        QrImageInput qrImageInput = new QrImageInput(bitmapImage );
        // Read the QR code
        QrReader qrReader = new QrReader();
        try
        {
     // Use the QR read method to read the values within your QR code(s)
            IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
            // Output the decoded value
            foreach (var result in results)
            {
                Console.WriteLine("QR Code Value: " + result.Value);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine("Error reading QR code: " + ex.Message);
        }
    }
}

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image using a file stream
        using var stream = File.OpenRead("sample-qr.png");
        var bitmapImage = AnyBitmap.FromStream(stream);
        QrImageInput qrImageInput = new QrImageInput(bitmapImage );
        // Read the QR code
        QrReader qrReader = new QrReader();
        try
        {
     // Use the QR read method to read the values within your QR code(s)
            IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
            // Output the decoded value
            foreach (var result in results)
            {
                Console.WriteLine("QR Code Value: " + result.Value);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine("Error reading QR code: " + ex.Message);
        }
    }
}

Saída do console

Este código carrega a imagem do código QR, lê o primeiro código QR detectado e imprime o conteúdo decodificado. Simples e eficaz. A partir daqui, você pode salvar os valores dos códigos QR para uso futuro.

Manipulando Múltiplos Códigos QR

Se sua imagem contiver múltiplos códigos QR (por exemplo, uma folha de etiquetas de produtos), você pode extrair todos eles. Para este exemplo, vamos passar a seguinte imagem de código QR pelo nosso programa:

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image from file
        var inputImage = AnyBitmap.FromFile("SampleCodes.png");
        QrImageInput qrImageInput = new QrImageInput(inputImage);
        // Read the QR code
        QrReader qrReader = new QrReader();
        IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
        // Output the decoded value
        foreach (var result in results)
        {
            Console.WriteLine("QR Code Value: " + result.Value);
        }
    }
}

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image from file
        var inputImage = AnyBitmap.FromFile("SampleCodes.png");
        QrImageInput qrImageInput = new QrImageInput(inputImage);
        // Read the QR code
        QrReader qrReader = new QrReader();
        IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
        // Output the decoded value
        foreach (var result in results)
        {
            Console.WriteLine("QR Code Value: " + result.Value);
        }
    }
}

Saída

Qualidade de Imagem Ruim

Imagens borradas ou de baixa resolução podem dificultar a detecção de um código QR. Use entradas de alta qualidade sempre que possível.

Código QR Não Detectado

Certifique-se de que a imagem não esteja muito escura, tenha um forte contraste, e que o código QR não esteja obscurecido. Tente cortar a imagem para focar na região do QR.

Tratamento de Exceções

Sempre envolva sua lógica de leitura de QR em blocos try-catch para lidar graciosamente com arquivos corrompidos ou formatos inesperados:

try
{
    IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
    // Output the decoded value
    foreach (var result in results)
    {
        Console.WriteLine("QR Code Value: " + result.Value);
    }
}
catch (Exception ex)
{
    Console.WriteLine("Error reading QR code: " + ex.Message);
}

try
{
    IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
    // Output the decoded value
    foreach (var result in results)
    {
        Console.WriteLine("QR Code Value: " + result.Value);
    }
}
catch (Exception ex)
{
    Console.WriteLine("Error reading QR code: " + ex.Message);
}