Cómo escanear un código QR en ASP.NET

Cómo escanear un código QR en ASP.NET

1. Crea un proyecto ASP.NET usando Visual Studio.
2. Instala la biblioteca IronQR desde el Administrador de Paquetes.
3. Sube la Imagen QR y Lee el QR.
4. Lee Código QR Avanzado.

Comprensión de los códigos QR y sus casos de uso

Los códigos QR (Respuesta Rápida) son códigos de barras bidimensionales que pueden almacenar información que va desde URLs hasta detalles de contacto, normalmente escaneados usando teléfonos inteligentes o dispositivos de escaneo dedicados. En las aplicaciones web, los códigos QR pueden servir para varios propósitos, tales como:

• Acceso rápido a sitios web: Dirigir a los usuarios a una URL específica sin necesidad de teclear.
• Boletos para eventos: Verificar códigos QR en boletos para acceso a eventos.
• Sistemas de pago: Facilitar el pago fácil escaneando un código QR.
• Información del producto: Proporcionar información adicional sobre productos.

Presentamos IronQR

IronQR es una poderosa biblioteca .NET diseñada para la generación y escaneo de códigos QR, proporcionando una funcionalidad robusta con facilidad de uso en mente. Esta versátil biblioteca no solo maneja códigos QR, sino que también puede gestionar otros tipos de códigos de barras, siendo una opción preferida para desarrolladores que trabajan dentro del ecosistema .NET. Aquí, exploraremos cómo integrar la biblioteca IronQR en una aplicación ASP.NET para facilitar el escaneo de códigos QR.

Principales ventajas y características de IronQR

1. Lectura de Códigos QR: IronQR puede leer códigos QR de varios formatos de imagen, incluidos jpg, png, svg, bmp, gif, tif, tiff y más. También soporta imágenes multipágina y modelos de detección QR personalizados. Los formatos de datos de salida incluyen texto, URLs, coordenadas, y más.

2. Escritura de Códigos QR: Puedes generar códigos QR y guardarlos como imágenes (jpg, png, gif, tiff, bmp), flujos, o incluso estamparlos en PDFs existentes. Codifica datos como texto, URLs, bytes, y números y genera códigos QR. Personaliza el estilo de los códigos QR redimensionando, ajustando márgenes, recoloreando y añadiendo logotipos.

3. Manejo y Corrección de Errores: IronQR proporciona mensajes de error detallados y corrección de errores QR personalizada. Asegura tolerancia a fallos y soporta comprobación de nulos y sumas de comprobación.

4. Modelo Avanzado de Aprendizaje Automático: IronQR utiliza un Modelo Avanzado de Aprendizaje Automático para el reconocimiento de códigos QR. Este modelo asegura una lectura precisa y confiable de códigos QR en diversas plataformas, incluidas móviles, escritorio y entornos en la nube.

5. Compatibilidad Multiplataforma: IronQR está diseñado para C#, F#, y VB.NET, operando en varias versiones de .NET como .NET Core (8, 7, 6, 5, y 3.1+), .NET Standard (2.0+), .NET Framework (4.6.2+).

6. Soporta diferentes tipos de proyectos, incluyendo web (Blazor & WebForms), móvil (Xamarin & MAUI), escritorio (WPF & MAUI), y aplicaciones de consola.

7. Amplio Soporte de Códigos QR: IronQR sobresale en el manejo de una amplia gama de códigos QR y otros tipos de códigos de barras. Ya sea que estés trabajando con códigos QR estándar, Micro QR, una imagen de código de barras QR, o incluso formatos específicos como Aztec o Data Matrix, IronQR te cubre. IronQR también soporta la funcionalidad para leer códigos de barras QR.

[IronQR](Iron Suite) de productos API .NET, que incluye varias herramientas para documentos de oficina, edición de PDF, OCR, y más.

Paso 1: Crear un nuevo proyecto ASP.NET con Visual Studio

Comienza creando un nuevo Proyecto y seleccionando la plantilla MVC como se muestra a continuación:

A continuación, debes proporcionar un nombre de proyecto y ubicación para el proyecto.

Selecciona la versión de .NET.

Al hacer clic en el botón de crear, se creará el siguiente código y proyecto.

Paso 2: Instalar la biblioteca IronQR desde el Administrador de paquetes de Visual Studio

Instala la biblioteca IronQR desde el gestor de paquetes de Visual Studio como se muestra a continuación:

IronQR también se puede instalar utilizando NuGet Gestor de Paquetes.

Paso 3: Cargue la imagen QR y léala

Ahora, creamos una App de código QR.

// Import necessary namespaces
using System.ComponentModel.DataAnnotations;

namespace IronQRScannerAsp.Models
{
    public class QRCodeModel
    {
        // Property to hold the uploaded QR code image
        [Display(Name = "Select QR Image")]
        public IFormFile QRCodeImage { get; set; }
    }
}

// Import necessary namespaces
using System.ComponentModel.DataAnnotations;

namespace IronQRScannerAsp.Models
{
    public class QRCodeModel
    {
        // Property to hold the uploaded QR code image
        [Display(Name = "Select QR Image")]
        public IFormFile QRCodeImage { get; set; }
    }
}

' Import necessary namespaces
Imports System.ComponentModel.DataAnnotations

Namespace IronQRScannerAsp.Models
	Public Class QRCodeModel
		' Property to hold the uploaded QR code image
		<Display(Name := "Select QR Image")>
		Public Property QRCodeImage() As IFormFile
	End Class
End Namespace

// Import necessary namespaces
using IronQr;
using IronQRScannerAsp.Models;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

namespace IronQRScannerAsp.Controllers
{
    // Controller to handle QR code scanning functionalities
    public class QrCodeController : Controller
    {
        private readonly IWebHostEnvironment _environment;

        // Constructor for dependency injection of the hosting environment
        public QrCodeController(IWebHostEnvironment environment)
        {
            _environment = environment;
        }

        // Displays the initial View
        public IActionResult Index()
        {
            ViewBag.QrCodeText = "Text";
            return View();
        }

        // Handles the POST request to scan a QR code
        [HttpPost]
        public IActionResult ScanQRCode(QRCodeModel qrImage)
        {
            string path = Path.Combine(_environment.WebRootPath, "ScanQRCode");
            if (!Directory.Exists(path))
            {
                Directory.CreateDirectory(path);
            }

            // Define the file path for saving the uploaded QR image
            string filePath = Path.Combine(_environment.WebRootPath, "ScanQRCode/qrcode.png");
            using (var stream = System.IO.File.Create(filePath))
            {
                qrImage.QRCodeImage.CopyTo(stream); // Save uploaded image to server
            }

            // Open the asset to read a QR Code from
            var bitmap = AnyBitmap.FromFile(filePath);

            // Load the asset into QrImageInput
            QrImageInput imageInput = new QrImageInput(bitmap);

            // Create a QR Reader object
            QrReader reader = new QrReader();

            // Read the Input and get all embedded QR Codes
            IEnumerable<QrResult> results = reader.Read(imageInput);

            // Display scanned text and image on the view
            ViewBag.QrCodeText = results.First().Value;
            string imageUrl = $"{this.Request.Scheme}://{this.Request.Host}{this.Request.PathBase}" + "/ScanQRCode/qrcode.png";
            ViewBag.QrCodeUri = imageUrl;

            return View();
        }
    }
}

// Import necessary namespaces
using IronQr;
using IronQRScannerAsp.Models;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

namespace IronQRScannerAsp.Controllers
{
    // Controller to handle QR code scanning functionalities
    public class QrCodeController : Controller
    {
        private readonly IWebHostEnvironment _environment;

        // Constructor for dependency injection of the hosting environment
        public QrCodeController(IWebHostEnvironment environment)
        {
            _environment = environment;
        }

        // Displays the initial View
        public IActionResult Index()
        {
            ViewBag.QrCodeText = "Text";
            return View();
        }

        // Handles the POST request to scan a QR code
        [HttpPost]
        public IActionResult ScanQRCode(QRCodeModel qrImage)
        {
            string path = Path.Combine(_environment.WebRootPath, "ScanQRCode");
            if (!Directory.Exists(path))
            {
                Directory.CreateDirectory(path);
            }

            // Define the file path for saving the uploaded QR image
            string filePath = Path.Combine(_environment.WebRootPath, "ScanQRCode/qrcode.png");
            using (var stream = System.IO.File.Create(filePath))
            {
                qrImage.QRCodeImage.CopyTo(stream); // Save uploaded image to server
            }

            // Open the asset to read a QR Code from
            var bitmap = AnyBitmap.FromFile(filePath);

            // Load the asset into QrImageInput
            QrImageInput imageInput = new QrImageInput(bitmap);

            // Create a QR Reader object
            QrReader reader = new QrReader();

            // Read the Input and get all embedded QR Codes
            IEnumerable<QrResult> results = reader.Read(imageInput);

            // Display scanned text and image on the view
            ViewBag.QrCodeText = results.First().Value;
            string imageUrl = $"{this.Request.Scheme}://{this.Request.Host}{this.Request.PathBase}" + "/ScanQRCode/qrcode.png";
            ViewBag.QrCodeUri = imageUrl;

            return View();
        }
    }
}

' Import necessary namespaces
Imports IronQr
Imports IronQRScannerAsp.Models
Imports IronSoftware.Drawing
Imports Microsoft.AspNetCore.Mvc

Namespace IronQRScannerAsp.Controllers
	' Controller to handle QR code scanning functionalities
	Public Class QrCodeController
		Inherits Controller

		Private ReadOnly _environment As IWebHostEnvironment

		' Constructor for dependency injection of the hosting environment
		Public Sub New(ByVal environment As IWebHostEnvironment)
			_environment = environment
		End Sub

		' Displays the initial View
		Public Function Index() As IActionResult
			ViewBag.QrCodeText = "Text"
			Return View()
		End Function

		' Handles the POST request to scan a QR code
		<HttpPost>
		Public Function ScanQRCode(ByVal qrImage As QRCodeModel) As IActionResult
			Dim path As String = System.IO.Path.Combine(_environment.WebRootPath, "ScanQRCode")
			If Not Directory.Exists(path) Then
				Directory.CreateDirectory(path)
			End If

			' Define the file path for saving the uploaded QR image
			Dim filePath As String = System.IO.Path.Combine(_environment.WebRootPath, "ScanQRCode/qrcode.png")
			Using stream = System.IO.File.Create(filePath)
				qrImage.QRCodeImage.CopyTo(stream) ' Save uploaded image to server
			End Using

			' Open the asset to read a QR Code from
			Dim bitmap = AnyBitmap.FromFile(filePath)

			' Load the asset into QrImageInput
			Dim imageInput As New QrImageInput(bitmap)

			' Create a QR Reader object
			Dim reader As New QrReader()

			' Read the Input and get all embedded QR Codes
			Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

			' Display scanned text and image on the view
			ViewBag.QrCodeText = results.First().Value
			Dim imageUrl As String = $"{Me.Request.Scheme}://{Me.Request.Host}{Me.Request.PathBase}" & "/ScanQRCode/qrcode.png"
			ViewBag.QrCodeUri = imageUrl

			Return View()
		End Function
	End Class
End Namespace

Explicación del código

El fragmento de código proporcionado es para un controlador ASP.NET Core MVC llamado QrCodeController, que está diseñado para manejar funcionalidades de escaneo de códigos QR usando la biblioteca IronQR. Aquí hay una breve descripción de lo que hace el código:

Agregar vista a la clase controlador

Añade una nueva vista, haz clic derecho en el método de acción CreateQRCode en la clase QrCodeController.

Selecciona la opción "Añadir Vista" luego selecciona "Vista Razor". Haz clic en "Agregar".

Luego selecciona la plantilla "Create" y la clase del Modelo generada previamente.

Ahora reemplaza el código en la clase de vista con el que se muestra a continuación.

@model IronQRScannerAsp.Models.QRCodeModel

@{
    ViewData["Title"] = "ScanQRCode";
}

<h1>ScanQRCode</h1>
<h4>QRCodeModel</h4>
<hr />
<div class="row">
    <div class="col-md-14">
        <form asp-action="ScanQRCode" enctype="multipart/form-data">
            <div asp-validation-summary="ModelOnly" class="text-danger"></div>
            <div class="form-group">
                <label for="QRCodeImage">Select QR Image:</label>
                <input asp-for="QRCodeImage" class="form-control" type="file" />
            </div>
            <div class="form-group">
                <input type="submit" value="Upload" class="btn btn-primary" />
            </div>
        </form>
    </div>
</div>
<div>
    <h3>Scanned Text:</h3>
    <h4>@ViewBag.QrCodeText</h4>
    @if (ViewBag.QrCodeUri != null)
    {
        <img src="@ViewBag.QrCodeUri" class="img-thumbnail" />
    }
</div>
<div>
    <a asp-action="Index">Clear</a>
</div>

@section Scripts {
    @{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}

Ahora en el Program.cs cambia el siguiente código para establecer la vista anterior como la ruta por defecto:

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=QrCode}/{action=Index}");

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=QrCode}/{action=Index}");

app.MapControllerRoute(name:= "default", pattern:= "{controller=QrCode}/{action=Index}")

Esto cambia la ruta por defecto de HomeController a nuestro Controlador QrCode.

Imagen de entrada con URL: https://ironsoftware.com/csharp/qr/.

Producción

En la página, selecciona una imagen de código QR y haz clic en cargar para decodificar el código QR. Esta aplicación también puede modificarse para leer desde una fuente de video y mostrar resultados.

Paso 4: Leer el código QR avanzado

Para leer códigos QR avanzados, IronQR proporciona las siguientes configuraciones.

// Import necessary namespaces
using IronQr;
using IronSoftware.Drawing;
using IronQr.Enum;
using System.Collections.Generic;

// Load an image file as a bitmap
var inputBmp = AnyBitmap.FromFile("QrImage.png");

// Use Auto => Machine Learning Scan
QrImageInput scan_ML_and_normal = new QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel);
IEnumerable<QrResult> results1 = new QrReader().Read(scan_ML_and_normal);

// Use Machine Learning Scan - High Speed
QrImageInput scan_ML_only = new QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel);
IEnumerable<QrResult> results2 = new QrReader().Read(scan_ML_only);

// Use Scan without Machine Learning
QrImageInput scan_normal_only = new QrImageInput(inputBmp, QrScanMode.OnlyBasicScan);
IEnumerable<QrResult> results3 = new QrReader().Read(scan_normal_only);

// Import necessary namespaces
using IronQr;
using IronSoftware.Drawing;
using IronQr.Enum;
using System.Collections.Generic;

// Load an image file as a bitmap
var inputBmp = AnyBitmap.FromFile("QrImage.png");

// Use Auto => Machine Learning Scan
QrImageInput scan_ML_and_normal = new QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel);
IEnumerable<QrResult> results1 = new QrReader().Read(scan_ML_and_normal);

// Use Machine Learning Scan - High Speed
QrImageInput scan_ML_only = new QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel);
IEnumerable<QrResult> results2 = new QrReader().Read(scan_ML_only);

// Use Scan without Machine Learning
QrImageInput scan_normal_only = new QrImageInput(inputBmp, QrScanMode.OnlyBasicScan);
IEnumerable<QrResult> results3 = new QrReader().Read(scan_normal_only);

' Import necessary namespaces
Imports IronQr
Imports IronSoftware.Drawing
Imports IronQr.Enum
Imports System.Collections.Generic

' Load an image file as a bitmap
Private inputBmp = AnyBitmap.FromFile("QrImage.png")

' Use Auto => Machine Learning Scan
Private scan_ML_and_normal As New QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel)
Private results1 As IEnumerable(Of QrResult) = (New QrReader()).Read(scan_ML_and_normal)

' Use Machine Learning Scan - High Speed
Private scan_ML_only As New QrImageInput(inputBmp, QrScanMode.OnlyDetectionModel)
Private results2 As IEnumerable(Of QrResult) = (New QrReader()).Read(scan_ML_only)

' Use Scan without Machine Learning
Private scan_normal_only As New QrImageInput(inputBmp, QrScanMode.OnlyBasicScan)
Private results3 As IEnumerable(Of QrResult) = (New QrReader()).Read(scan_normal_only)

Aprovechando lo último en tecnología de ML, hemos elevado el lector de códigos QR a nuevas alturas. El sofisticado modelo de ML mejora la precisión y eficiencia de las aplicaciones en la decodificación de códigos QR, incluso bajo condiciones complejas. Ya sea leyendo códigos QR de imágenes fijas, flujos de video, o transmisiones en vivo de cámaras, la solución potenciada por ML proporciona la información requerida de manera rápida y confiable. Esta innovación simplifica la recuperación de datos y aumenta la seguridad al identificar códigos QR genuinos y marcar posibles amenazas. Con nuestra tecnología ML, puedes estar seguro de que tus capacidades de escaneo de códigos QR están a la vanguardia, proporcionando a tus usuarios una experiencia fluida y segura.

Licencia (versión de prueba disponible)

Los desarrolladores pueden obtener una licencia de prueba de IronQR desde aquí. La clave debe colocarse en el appSettings.json.

{
  "IronQR.License.LicenseKey": "My Key"
}

Conclusión

En este artículo, hemos explorado cómo escanear códigos QR en ASP.NET Core usando IronQR. Integrar IronQR en una aplicación ASP.NET para escaneo de códigos QR es un proceso sencillo que mejora las capacidades de las aplicaciones web, haciéndolas más interactivas y fáciles de usar. Las características poderosas de IronQR y su facilidad de uso lo convierten en una excelente opción para desarrolladores que buscan implementar funcionalidades relacionadas con códigos de barras.