Código QR .NET Core: Leer y generar códigos QR en C#

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

La instalación de IronQR a través de NuGet lleva unos segundos. Abra Visual Studio, vaya a Herramientas > Administrador de paquetes NuGet > Administrar paquetes NuGet para la solución , busque IronQR y haga clic en Instalar . El paquete tiene dependencias mínimas y está destinado a Windows, macOS y Linux desde el primer momento.

Install-Package IronQR

IronQR está dirigido a .NET Core 6, 7, 8, 9 y 10, así como a .NET Framework 4.6.2 y versiones posteriores. Para proyectos multiplataforma, una integración de SkiaSharp maneja el procesamiento de imágenes en entornos de ejecución que no son Windows. La biblioteca funciona con aplicaciones web ASP.NET Core , aplicaciones de consola y soluciones de escritorio sin configuración de tiempo de ejecución adicional. Una vez instalado, todos los métodos y tipos de extensión necesarios estarán disponibles inmediatamente.

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

Para leer datos de códigos QR desde archivos de imagen solo se requieren unas pocas líneas de código. La clase QrReader utiliza un modelo de aprendizaje automático avanzado que evalúa la calidad de la imagen y selecciona automáticamente el modo de segmento correcto, lo que le brinda resultados precisos incluso cuando la imagen de entrada no es ideal.

using IronQr;
using IronSoftware.Drawing;

// 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;

// 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 se extraen datos de códigos QR avanzados?

Más allá de la decodificación de valores básicos, IronQR expone coordenadas, segmentos de datos sin procesar e información a nivel de módulo de cada símbolo escaneado. Esto es esencial para los flujos de trabajo de procesamiento de documentos donde necesita saber exactamente dónde apareció un código QR en la página, o para aplicaciones que deben manejar múltiples códigos en una sola imagen.

using IronQr;
using IronSoftware.Drawing;

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 decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

using IronQr;
using IronSoftware.Drawing;

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 decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

¿Cómo afectan los niveles de corrección de errores a la calidad del código QR?

La corrección de errores es el mecanismo que permite a un escáner QR recuperar los datos originales incluso cuando parte del código está oscurecido, mal impreso o dañado físicamente. El estándar del código QR define cuatro niveles: Bajo (L), Medio (M), Cuartil (Q) y Alto (H), cada uno de los cuales intercambia capacidad de almacenamiento por tolerancia al daño.

Al generar códigos QR, especificar un nivel de corrección de errores más alto garantiza que el resultado se mantenga en condiciones de escaneo reales:

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 generar códigos QR con caracteres internacionales?

IronQR admite la gama completa de modos de codificación QR : numérico, alfanumérico, byte y kanji. Para texto en japonés y otros contenidos Unicode, la biblioteca selecciona automáticamente la codificación que ahorra más espacio:

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects 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 selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

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

Un código QR que codifica una URL simple funciona para compartir enlaces simples, pero muchas aplicaciones necesitan codificar datos estructurados (credenciales de WiFi, tarjetas de contacto en formato vCard o datos de eventos). Formatear estas cargas útiles manualmente es propenso a errores; Un punto y coma faltante o un orden de campos incorrecto harán que los escáneres malinterpreten los datos.

IronQR proporciona ayudantes de carga útil que construyen estas cadenas estructuradas correctamente:

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.");

¿Cómo personalizar la apariencia del código QR?

IronQR le brinda control sobre la apariencia visual de los códigos generados sin sacrificar la capacidad de escaneo. Puede cambiar los colores de primer plano y de fondo, aplicar una marca personalizada o incrustar un logotipo en la zona tranquila del centro.

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

Incrustar un logotipo reduce el área de datos efectiva, por lo que la biblioteca requiere un nivel de corrección de errores H cuando se proporciona un logotipo. La zona tranquila reservada en el centro representa aproximadamente el 30% de la superficie del código, que está dentro de la capacidad de recuperación del nivel H. La biblioteca aplica esta restricción automáticamente: si establece un nivel de corrección de errores más bajo junto con un logotipo, IronQR genera una excepción con un mensaje descriptivo en lugar de producir un código que se escanea de manera poco confiable.

Para las aplicaciones ASP.NET Core , el tutorial del generador de códigos QR de ASP.NET Core muestra cómo servir códigos QR generados como respuestas de imágenes de una acción del controlador. El flujo de salida escribe directamente en la respuesta sin E/S de archivo intermedia, lo que mantiene la latencia baja para los puntos finales de alto tráfico.

¿Cómo se leen códigos QR en una aplicación ASP.NET Core ?

El escaneo de códigos QR del lado del servidor (desde imágenes cargadas, canales de procesamiento de documentos o sistemas de inspección automatizados) es un caso de uso común para la API de lectura. La guía del escáner de código QR ASP.NET cubre la configuración completa del controlador y del servicio, pero el patrón de lectura principal es el mismo que el de una aplicación de consola:

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

El método AnyBitmap.FromStream() acepta cualquier flujo legible, por lo que la misma ruta de código funciona para archivos subidos a través de un formulario, imágenes obtenidas del almacenamiento de blobs o fotogramas extraídos de una canalización de vídeo. El controlador no escribe archivos temporales en el disco, lo cual es importante para implementaciones en contenedores donde el sistema de archivos puede ser de solo lectura.

Para escenarios de alto rendimiento, cree una instancia de QrReader una vez por vida útil de la aplicación como singleton, ya que el costo de carga del modelo ML se paga en la primera construcción. Las llamadas Read() subsiguientes en la misma instancia son seguras para subprocesos y comparten el modelo cargado.

¿Cómo generar códigos QR en una aplicación .NET MAUI ?

El tutorial del código QR .NET MAUI demuestra la generación multiplataforma completa en iOS, Android, macOS y Windows. IronQR utiliza el backend de renderizado SkiaSharp cuando se ejecuta en plataformas que no son Windows, lo que proporciona una salida consistente en todos los objetivos MAUI.

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

En destinos móviles, ExportBytes() devuelve una matriz de bytes PNG que puedes introducir directamente en un StreamImageSource o escribir en un ImageButton. El andamio MAUI no requiere rutas de código específicas de la plataforma: la misma lógica de generación se ejecuta de manera idéntica en los cuatro objetivos MAUI.

Para los proyectos VB .NET , la superficie de la API es idéntica; Sólo difiere la sintaxis. La biblioteca envía un único paquete NuGet sin necesidad de un ensamblaje VB .NET separado.

¿Cuales son tus próximos pasos?

IronQR cubre el ciclo de vida completo del código QR en .NET , desde la generación básica y la codificación de carga estructurada hasta la lectura impulsada por ML de códigos dañados o de marca. La biblioteca maneja la codificación Kanji, la configuración de corrección de errores y la salida de imágenes multiplataforma, lo que le permite concentrarse en la lógica específica de su aplicación.

Para poner en práctica lo aprendido:

• Revise el tutorial del lector de códigos QR de C# para obtener una visión más profunda de la API de lectura y el procesamiento de resultados.
• Siga el tutorial de la aplicación generador de código QR de C# para obtener un recorrido completo del proyecto.
• Explore los ejemplos de código para ver patrones de generación y lectura adicionales.
• Compre una licencia de IronQR para desbloquear todas las funciones para la implementación de producción o extienda la prueba gratuita si necesita más tiempo de evaluación.