Cómo leer códigos QR con diferentes modos de escaneo

This article was translated from English: Does it need improvement?
Translated
View the article in English

La lectura de códigos QR se ha convertido en una tarea rutinaria en 2025 a medida que más productos avanzan hacia la digitalización y el acceso siempre en línea. Almacenar los datos necesarios en impresiones compactas y de solo lectura es ahora el estándar, y los desarrolladores necesitan formas efectivas de extraer esa información en diferentes entornos.

IronQR ofrece 3 opciones de lectura para códigos QR, cada una diseñada para casos de uso específicos.

En esta guía práctica, se explicarán los tres métodos con ejemplos claros. Si aún no lo has revisado, echa un vistazo a la guía anterior sobre cómo leer códigos QR a partir de imágenes o escribir tu propio código QR.

Comprensión de los modos de escaneo de códigos QR

IronQR ofrece tres potentes modos de escaneo a través de la enumeración QrScanMode :

  • Modo automático ( QrScanMode.Auto ): combina la detección de aprendizaje automático y algoritmos de escaneo básicos para lograr máxima precisión y confiabilidad
  • Solo modo de escaneo básico ( QrScanMode.OnlyBasicScan ): utiliza técnicas de procesamiento de imágenes convencionales para un escaneo rápido y confiable cuando los códigos QR son claramente visibles
  • Modo de modelo de detección ( QrScanMode.OnlyDetectionModel ): aprovecha el aprendizaje automático para detectar posiciones de códigos QR, ideal para extraer datos de coordenadas

Exploremos cada método de escaneo en detalle.


Solo modo de escaneo básico

Solo el modo de escaneo básico utiliza algoritmos de procesamiento de imágenes tradicionales sin el uso de aprendizaje automático. Este método es rápido y eficiente cuando los códigos QR son claramente visibles y bien posicionados; Sin embargo, todavía funciona en códigos QR dañados si los tres cuadrados de las esquinas son legibles.

:path=/static-assets/qr/content-code-examples/how-to/read-qr-codes-with-scan-modes-basic.cs
using System.Linq;
using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.IO;

 // Load the image
var bmp = AnyBitmap.FromFile("damaged-qr.png");

// Create scan input using Only Basic Scan mode
var input = new QrImageInput(bmp, QrScanMode.OnlyBasicScan);

// Get the result
var result = new QrReader().Read(input).FirstOrDefault();

// Save the output to a text file
File.WriteAllText("basic-scan-output.txt", result.Value);
$vbLabelText   $csharpLabel

Entrada de escaneo

Código QR dañado

Archivo de texto guardado

Archivo de texto

Modo de escaneo automático

El modo de escaneo automático es el predeterminado (para QrScanMode ) y la opción más versátil disponible. Combina automáticamente la detección de aprendizaje automático con algoritmos de escaneo tradicionales para ofrecer los mejores resultados posibles en una variedad de condiciones de imagen.

El ejemplo muestra una imagen que se carga y se activa el modo Auto . Luego escanea la imagen y recopila todos los códigos QR que encuentra en una lista. Finalmente, revisa la colección results e imprime el texto de cada valor en la consola (en este caso, solo la URL).

:path=/static-assets/qr/content-code-examples/how-to/read-qr-codes-with-scan-modes-auto.cs
using System;
using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;

// Load the image file
var bmp = AnyBitmap.FromFile("cup.png");

// Create scan input using Auto Scan mode
var input = new QrImageInput(bmp, QrScanMode.Auto);

// Scan and read all QR codes
var results = new QrReader().Read(input);

// Initialize a counter to track the number of QR codes
int count = 1;

// Loop through each discovered QR code
foreach (var result in results)
{
    Console.WriteLine($"QR {count}: {result.Value}");
    count++;
}
$vbLabelText   $csharpLabel

Entrada de escaneo

Taza con enlace al sitio web del Café

Pantalla de la consola

La URL del sitio web de la cafetería se registra después de escanear la foto a través de IronQR.

Visualización de la URL del sitio web en la consola

Modo de modelo de detección

El modo de modelo de detección utiliza aprendizaje automático específicamente para detectar posiciones de códigos QR dentro de las imágenes. Esta cualidad lo hace invaluable para aplicaciones de análisis espacial y visión por computadora. El sistema de coordenadas que utiliza tiene el origen en (0, 0) .

Generalmente, los escáneres QR utilizan algoritmos de decodificación estándar que se basan en tres patrones de búsqueda; este modelo captura los cuatro vértices del ID. El objeto result contiene una colección Points que se itera para recuperar los datos de posición.

El código reutiliza la foto de la taza del ejemplo anterior para demostrar la detección de valores posicionales dentro de la imagen.

Por favor notaLas coordenadas que devuelve esta función se almacenan en una secuencia estricta en "zig-zag": arriba a la izquierda, arriba a la derecha, abajo a la izquierda y, finalmente, abajo a la derecha.

:path=/static-assets/qr/content-code-examples/how-to/read-qr-codes-with-scan-modes-detection-model.cs
using System;
using System.Linq;
using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;

// Load the image
var bmp = AnyBitmap.FromFile("cup.png");

// Create scan input using Detection Model mode
var input = new QrImageInput(bmp, QrScanMode.OnlyDetectionModel);

// Read QR code
var result = new QrReader().Read(input).FirstOrDefault();

// Print position data
if (result != null)
{
    if (result.Points != null)
    {
        foreach (var point in result.Points)
        {
            Console.WriteLine($"Point: X={point.X}, Y={point.Y}");
        }
    }
}
$vbLabelText   $csharpLabel

Imagen de taza etiquetada

Taza etiquetada

Consola etiquetada

Consola etiquetada

Comparación de métodos de escaneo

Característica ( QRScanMode )Escaneo básico ( OnlyBasicScan escaneo básico)Escaneo automático ( Auto )Modelo de detección ( OnlyDetectionModel )
SalidaTexto decodificado (valor)Texto decodificado (valor)Coordenadas (Puntos)
AlgoritmoSólo tradicionalHíbrido (ML + Tradicional)Solo aprendizaje automático
EnfocarVelocidadLegibilidad / RecuperaciónLocalización / Visión artificial

Conclusión

Los tres modos de escaneo de IronQR brindan flexibilidad para cualquier escenario de lectura de códigos QR:

  • Escaneo automático : Máxima precisión y fiabilidad para uso general
  • Escaneo básico : velocidad y eficiencia para imágenes de alta calidad
  • Modelo de detección : conocimiento de la posición para aplicaciones espaciales

Al comprender las fortalezas de cada método, puede optimizar la implementación de lectura de códigos QR para sus requisitos específicos. Ya sea que necesite una extracción de datos integral, un procesamiento ultrarrápido o una detección de posición precisa, IronQR lo tiene cubierto.

Para obtener más ejemplos e información detallada sobre la API, visita la documentación de IronQR o explora los ejemplos de código en GitHub .

Preguntas Frecuentes

¿Cuáles son los diferentes modos de escaneo disponibles para leer códigos QR?

IronQR ofrece varios modos de escaneo, como escaneo automático, manual y por lotes, para leer códigos QR de manera eficiente en diferentes escenarios.

¿Cómo puedo implementar el escaneo de código QR en un proyecto C#?

Puede implementar el escaneo de códigos QR en un proyecto C# integrando la biblioteca IronQR, que proporciona métodos fáciles de usar para leer códigos QR con diferentes modos de escaneo.

¿Cuáles son los beneficios de utilizar IronQR para escanear códigos QR?

IronQR proporciona alta precisión, procesamiento rápido y admite diferentes modos de escaneo, lo que lo convierte en una opción versátil para el escaneo de códigos QR en proyectos de C#.

¿Es posible leer varios códigos QR a la vez usando IronQR?

Sí, IronQR admite el modo de escaneo por lotes, lo que le permite leer múltiples códigos QR simultáneamente para una mayor eficiencia.

¿IronQR admite el escaneo de códigos QR de varias fuentes?

IronQR puede escanear códigos QR de diversas fuentes, incluidas imágenes, archivos PDF y transmisiones de cámaras en vivo, lo que brinda flexibilidad a los desarrolladores.

¿Puede IronQR manejar códigos QR con diferentes orientaciones?

Sí, IronQR está diseñado para leer códigos QR con precisión independientemente de su orientación, lo que garantiza resultados de escaneo confiables.

¿Cómo funciona el modo de escaneo automático en IronQR?

El modo de escaneo automático de IronQR detecta y lee de forma inteligente los códigos QR sin necesidad de entrada manual, lo que agiliza el proceso de escaneo.

¿Qué habilidades de programación se requieren para utilizar IronQR para escanear códigos QR?

El conocimiento básico de programación en C# es suficiente para utilizar IronQR para el escaneo de códigos QR, ya que la biblioteca ofrece una integración y un uso sencillos.

¿Hay una versión de prueba de IronQR disponible para probar?

Sí, IronQR ofrece una versión de prueba que permite a los desarrolladores probar sus funciones y modos de escaneo antes de comprometerse con una compra.

¿Dónde puedo descargar la biblioteca IronQR?

La biblioteca IronQR se puede descargar del sitio web de Iron Software, donde también puede encontrar documentación y recursos de soporte.

Ahmad Sohail
Desarrollador Full Stack

Ahmad es un desarrollador full-stack con una sólida base en C#, Python y tecnologías web. Tiene un profundo interés en construir soluciones de software escalables y disfruta explorando cómo el diseño y la funcionalidad se encuentran en aplicaciones del mundo real.

Antes ...

Leer más
¿Listo para empezar?
Nuget Descargas 55,860 | Versión: 2025.12 recién lanzado