Cómo leer QR desde una imagen en C#

Características clave

• Leer y generar códigos QR con facilidad.
• Soporte para formatos de imagen JPEG, PNG, BMP y otros.
• Alto rendimiento y detección precisa para facilitar la extracción de datos de códigos QR.
• Funciona en proyectos de .NET Framework, .NET Core, .NET Standard (2.0+) y .NET 6/7+.
• Ofrece soporte multiplataforma, por lo que puedes trabajar en tu entorno y sistema operativo preferidos, ya sea Windows, Linux o cualquier otro entorno compatible.

A diferencia de las alternativas de código abierto, IronQR se centra en la estabilidad a nivel empresarial, licencias comerciales y soporte profesional, lo que lo convierte en una excelente opción para aplicaciones críticas para el negocio.

Instalar a través de NuGet

Puedes instalar IronQR directamente desde la Consola del Administrador de Paquetes NuGet:

Install-Package IronQR

Install-Package IronQR

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronQR

Alternativamente, usa la GUI de NuGet en Visual Studio buscando IronQR y haz clic en 'Instalar':

Agregar espacios de nombres y configuración básica

Una vez instalado, incluye el siguiente espacio de nombres en tu archivo C#:

using IronSoftware.Drawing;
using IronQR;

using IronSoftware.Drawing;
using IronQR;

Imports IronSoftware.Drawing
Imports IronQR

Nota: Iron Software.Drawing se usa para manejar formatos de imagen de manera multiplataforma.

Formatos de imagen admitidos

IronQR admite múltiples tipos de formatos de imagen, incluidos:

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

Esta flexibilidad te permite trabajar con prácticamente cualquier fuente de imagen, desde instantáneas de cámaras hasta documentos escaneados.

Ejemplo de código básico

Veamos más de cerca cómo puedes utilizar esta biblioteca para decodificar códigos QR con facilidad. Aquí tienes un ejemplo mínimo que lee un solo código QR con el valor de texto '¡Hola Mundo!' desde un archivo de imagen, utilizando la clase Bitmap y un flujo de archivos para cargar la imagen:

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);
        }
    }
}

Imports IronQr
Imports IronSoftware.Drawing
Imports System
Friend Class Program
	Shared Sub Main()
		' Load the image using a file stream
		Dim stream = File.OpenRead("sample-qr.png")
		Dim bitmapImage = AnyBitmap.FromStream(stream)
		Dim qrImageInput As New QrImageInput(bitmapImage)
		' Read the QR code
		Dim qrReader As New QrReader()
		Try
	 ' Use the QR read method to read the values within your QR code(s)
			Dim results As IEnumerable(Of QrResult) = qrReader.Read(qrImageInput)
			' Output the decoded value
			For Each result In results
				Console.WriteLine("QR Code Value: " & result.Value)
			Next result
		Catch ex As Exception
			Console.WriteLine("Error reading QR code: " & ex.Message)
		End Try
	End Sub
End Class

Salida de la Consola

Este código carga la imagen del código QR, lee el primer código QR detectado e imprime el contenido decodificado. Simple y efectivo. Desde aquí, puedes guardar los valores de los códigos QR para su uso posterior.

Manejo de múltiples códigos QR

Si tu imagen contiene varios códigos QR (por ejemplo, una hoja de etiquetas de productos), puedes extraerlos todos. Para este ejemplo, ejecutaremos la siguiente imagen de Código QR a través de nuestro 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);
        }
    }
}

Imports IronQr
Imports IronSoftware.Drawing
Imports System
Friend Class Program
	Shared Sub Main()
		' Load the image from file
		Dim inputImage = AnyBitmap.FromFile("SampleCodes.png")
		Dim qrImageInput As New QrImageInput(inputImage)
		' Read the QR code
		Dim qrReader As New QrReader()
		Dim results As IEnumerable(Of QrResult) = qrReader.Read(qrImageInput)
		' Output the decoded value
		For Each result In results
			Console.WriteLine("QR Code Value: " & result.Value)
		Next result
	End Sub
End Class

Output

Mala calidad de imagen

Las imágenes borrosas o de baja resolución pueden dificultar la detección de un código QR. Usa entradas de alta calidad siempre que sea posible.

Código QR no detectado

Asegúrate de que la imagen no sea demasiado oscura, tenga un fuerte contraste y que el código QR no esté obstruido. Intenta recortar la imagen para enfocarte en la región QR.

Manejo de excepciones

Siempre envuelve tu lógica de lectura de QR en bloques try-catch para manejar con elegancia archivos corruptos o 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);
}

Try
	Dim results As IEnumerable(Of QrResult) = qrReader.Read(qrImageInput)
	' Output the decoded value
	For Each result In results
		Console.WriteLine("QR Code Value: " & result.Value)
	Next result
Catch ex As Exception
	Console.WriteLine("Error reading QR code: " & ex.Message)
End Try