Generador de Códigos QR .NET Core: Leer y generar códigos QR con sólo unas pocas líneas de código

¿Cómo instalar la biblioteca de códigos QR?

La instalación de IronQR a través del gestor de paquetes NuGet es una operación sencilla que se realiza en cuestión de segundos. Abra Visual Studio, vaya a Herramientas > Gestor de paquetes NuGet y busque "IronQR" Haz clic en el botón de instalación para añadir el paquete NuGet a tu proyecto. La biblioteca tiene dependencias NuGet mínimas y es compatible con proyectos multiplataforma en Windows, macOS y Linux.

Install-Package IronQR

IronQR es una implementación de .NET compatible con .NET Core 6, 7, 8 y 9, así como con .NET Framework 4.6.2+. Para proyectos multiplataforma, la integración de SkiaSharp permite el procesamiento de imágenes entre plataformas. La biblioteca es compatible con aplicaciones web ASP.NET Core, aplicaciones de consola y soluciones de escritorio sin necesidad de configuración adicional. Una vez instalado, el código fuente incluye automáticamente todos los métodos de extensión necesarios para las operaciones QR.

¿Cómo puedo leer un código QR básico a partir de una imagen?

Lectura de datos de código QR a partir de imágenes PNG u otros formatos requiere sólo unas pocas líneas de código. La clase QrReader utiliza un modelo avanzado de aprendizaje automático de códigos QR que evalúa automáticamente la calidad de la imagen y aplica una detección óptima del modo de segmento para una descodificación precisa.

using IronQr;
using IronSoftware.Drawing;
namespace Examples
{
    class Program
    {
        static void Main(string[] args)
        {
            // Load image containing QR code
            var inputBmp = AnyBitmap.FromFile("qr-sample.png");
            // Create QrImageInput from the bitmap
            QrImageInput imageInput = new QrImageInput(inputBmp);
            // Initialize QR Reader with ML model
            QrReader reader = new QrReader();
            // Read and decode all QR codes in the image
            IEnumerable<QrResult> results = reader.Read(imageInput);
            // Output decoded text strings
            foreach (var qrCode in results)
            {
                Console.WriteLine($"QR Code Value: {qrCode.Value}");
                Console.WriteLine($"URL: {qrCode.Url}");
            }
        }
    }
}

using IronQr;
using IronSoftware.Drawing;
namespace Examples
{
    class Program
    {
        static void Main(string[] args)
        {
            // Load image containing QR code
            var inputBmp = AnyBitmap.FromFile("qr-sample.png");
            // Create QrImageInput from the bitmap
            QrImageInput imageInput = new QrImageInput(inputBmp);
            // Initialize QR Reader with ML model
            QrReader reader = new QrReader();
            // Read and decode all QR codes in the image
            IEnumerable<QrResult> results = reader.Read(imageInput);
            // Output decoded text strings
            foreach (var qrCode in results)
            {
                Console.WriteLine($"QR Code Value: {qrCode.Value}");
                Console.WriteLine($"URL: {qrCode.Url}");
            }
        }
    }
}

¿Cómo extraer datos avanzados de códigos QR?

Más allá de la lectura básica de códigos QR, IronQR expone coordenadas, módulos sin procesar y segmentos de datos estructurados de cada código escaneado. Esto resulta esencial para las aplicaciones que requieren un posicionamiento preciso de los símbolos QR o el procesamiento simultáneo de varios códigos.

using IronQr;
using IronSoftware.Drawing;
namespace Examples
{
    class AdvancedReader
    {
        static void Main(string[] args)
        {
            var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
            QrImageInput imageInput = new QrImageInput(inputBmp);
            QrReader reader = new QrReader();
            IEnumerable<QrResult> results = reader.Read(imageInput);
            foreach (var qrCode in results)
            {
                // Access QR code data and URL
                Console.WriteLine($"Data: {qrCode.Value}");
                // Get coordinate positions (int x, int y)
                foreach (PointF point in qrCode.Points)
                {
                    Console.WriteLine($"Position: {point.X}, {point.Y}");
                }
            }
        }
    }
}

using IronQr;
using IronSoftware.Drawing;
namespace Examples
{
    class AdvancedReader
    {
        static void Main(string[] args)
        {
            var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
            QrImageInput imageInput = new QrImageInput(inputBmp);
            QrReader reader = new QrReader();
            IEnumerable<QrResult> results = reader.Read(imageInput);
            foreach (var qrCode in results)
            {
                // Access QR code data and URL
                Console.WriteLine($"Data: {qrCode.Value}");
                // Get coordinate positions (int x, int y)
                foreach (PointF point in qrCode.Points)
                {
                    Console.WriteLine($"Position: {point.X}, {point.Y}");
                }
            }
        }
    }
}

¿Cómo afecta el nivel de corrección de errores a la lectura de códigos QR?

La corrección de errores es fundamental para la fiabilidad de los códigos QR. IronQR admite todos los niveles estándar de corrección de errores (L, M, Q, H), y los niveles superiores permiten una mayor recuperación de datos de códigos dañados u oscurecidos. El número máximo de versión permitido determina la capacidad; los códigos QR de la versión 40 almacenan hasta 7.089 caracteres numéricos.

Al generar códigos QR, especificar el nivel de corrección de errores garantiza que el resultado resista las condiciones de escaneado del mundo real:

using IronQr;
using IronSoftware.Drawing;
// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;
// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

¿Cómo puedo generar códigos QR con caracteres internacionales?

IronQR admite codificación que codifica texto Unicode japonés mediante el modo Kanji, lo que lo hace ideal para aplicaciones internacionales. La biblioteca selecciona automáticamente el modo de segmento óptimo para contenido mixto numérico, alfanumérico o Unicode. También puede configurar segmentos de datos manualmente o añadir segmentos ECI para conjuntos de caracteres específicos.

using IronQr;
using IronSoftware.Drawing;
// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library handles kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

using IronQr;
using IronSoftware.Drawing;
// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library handles kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

¿Cómo se utilizan los generadores de carga útil para datos estructurados?

IronQR admite generadores de carga útil que crean datos de código QR con el formato adecuado para casos de uso comunes como credenciales WiFi, información de contacto y eventos de calendario. Esto simplifica la creación de códigos QR con información estructurada en lugar de texto sin formato.

using IronQr;
using IronSoftware.Drawing;
// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully!");

using IronQr;
using IronSoftware.Drawing;
// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully!");

Conclusión

IronQR no es sólo para leer imágenes estáticas perfectas; brilla cuando hay que escanear códigos borrosos o dañados en entornos reales. La compatibilidad de la biblioteca con funciones avanzadas opcionales, como la configuración de patrones de máscara, el estilo personalizado y la codificación internacional de caracteres, la hace adecuada para aplicaciones empresariales que requieren fiabilidad y flexibilidad.

Desde generar códigos QR hasta leer símbolos QR complejos a partir de varios formatos de imagen, IronQR gestiona el flujo de trabajo completo con un código mínimo. La sencilla documentación de la API y los extensos tutoriales ayudan a los desarrolladores a implementar rápidamente la funcionalidad de QR.

Compra una licencia IronQR para desbloquear todas las capacidades para el despliegue en producción, o explora ejemplos de código adicionales para ver la biblioteca en acción.