Los códigos QR (Códigos de Respuesta Rápida) están en todas partes: en empaques de productos, boletos de eventos, menús e incluso tarjetas de presentación. Como desarrollador .NET, poder leer códigos QR de imágenes de manera rápida y confiable puede abrir la puerta a potentes funciones de automatización e interacción del usuario. En esta guía, te mostraremos cómo usar IronQR, una biblioteca de códigos QR de alto rendimiento creada específicamente para .NET, para leer códigos QR de imágenes con solo unas pocas líneas de código C#.

Ya sea que estés desarrollando software de gestión de inventario, integrando autenticación de dos factores o simplemente decodificando URLs desde capturas de pantalla, IronQR lo hace fácil.

¿Qué es IronQR?

IronQR es una potente biblioteca de códigos QR en C# desarrollada para crear un lector y escritor de códigos QR potente para desarrolladores de .NET. IronQR está diseñado tanto para la generación como para la lectura de códigos QR, y soporta la lectura desde una variedad de formatos de imagen, lo que lo hace ideal para su uso en aplicaciones de escritorio, web o servidor. A través de esta biblioteca, puedes crear herramientas precisas para el reconocimiento y la lectura de códigos QR y automatizar todo el proceso.

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.

Configurando IronQR en tu proyecto C#

Antes de que puedas comenzar a escanear códigos QR, repasemos cómo configurar IronQR en tu aplicación .NET.

Instalar a través de NuGet

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

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

Imports IronSoftware.Drawing
Imports IronQR

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

Leer código QR desde una imagen

Pasemos a cómo realmente leer un código QR desde un archivo usando IronQR.

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

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 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 del código QR para su uso futuro.

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

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

Salida

Casos de uso comunes para el escaneo de códigos QR

Aquí hay algunos escenarios del mundo real donde la lectura de códigos QR desde imágenes resulta valiosa:

• Gestión de inventario y activos: Automatice la identificación de artículos escaneando códigos QR de las imágenes de los paquetes.
• Autenticación de dos factores (2FA): Analiza los códigos QR de las pantallas de configuración de 2FA para facilitar una configuración segura.
• Integración con aplicaciones móviles: abre URL móviles o enlaces profundos específicos de la aplicación escaneando capturas de pantalla de códigos QR compartidos.
• Venta de entradas para eventos: Valida los códigos QR de las entradas enviadas por correo electrónico o mostrados en pantalla.
• Pasarelas de pago: Extrae datos de pago incrustados en códigos QR para aplicaciones fintech.

En todos estos casos de uso, el reconocimiento rápido y preciso es clave, algo que IronQR maneja con facilidad.

Consejos para la solución de problemas

Si encuentras problemas al leer códigos QR, considera lo siguiente:

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

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

Reflexiones finales

La lectura de códigos QR desde imágenes en C# no tiene que ser difícil. Con IronQR, puedes integrar el escaneo de códigos QR en tus aplicaciones .NET con solo unas pocas líneas de código. Su simplicidad, compatibilidad multiplataforma y excelente rendimiento lo convierten en una herramienta ideal para los desarrolladores que trabajan en sistemas modernos habilitados para QR.

Si buscas extender esta funcionalidad, considera explorar:

• Generación de códigos QR para crear tus propios códigos escaneables.
• Integración con IronBarcode o IronOCR para capacidades de escaneo aún más amplias. ¿Listo para comenzar?

Instala la prueba gratuita de IronQR para comenzar hoy y descubre cómo esta biblioteca puede elevar tus tareas de códigos QR.