Tienes un código QR y nada lo lee. La cámara se queda encima, el lector gira, y no obtienes nada. Frustrante, pero un QR que no se decodifica casi siempre falla por una de unas pocas razones concretas, y la mayoría las puedes arreglar en menos de un minuto. Aquí tienes cómo averiguar con cuál te estás topando.
1. El código es demasiado pequeño en el encuadre
Esta es de lejos la causa más común. Un código QR necesita suficientes píxeles para que el decodificador distinga su patrón. Si el código es un cuadradito en la esquina de una captura grande, o una mota distante en una foto, sencillamente no hay suficiente detalle para leerlo.
Solución: recorta más cerca. Recorta la imagen para que el QR llene la mayor parte del encuadre antes de intentar decodificarlo. Un código que llenaba el 5 % de una captura a menudo se lee al instante una vez recortado para llenar el 80 %.
2. Está borroso o desenfocado
El desenfoque de movimiento de una foto temblorosa, o un enfoque blando, difuminan los bordes nítidos de los que depende el patrón. El decodificador necesita transiciones nítidas de blanco y negro.
Solución: si es una foto, vuelve a hacerla con pulso firme, tocando para enfocar el código. Si es una captura de algo ya borroso, hay menos que puedas hacer, pero recortar al código e intentarlo de nuevo aún vale la pena, ya que una región nítida más pequeña a veces se decodifica donde la imagen blanda entera no lo hizo.
3. Bajo contraste o colores extraños
Un QR depende de una diferencia clara entre los módulos oscuros y el fondo claro. Una impresión desvaída, un código sobre un fondo recargado, o un código estilizado donde lo "oscuro" es un color pálido pueden caer todos por debajo del umbral.
Solución: prefiere una versión nítida oscuro sobre claro si la tienes. Buenas noticias sobre los códigos invertidos, eso sí: un lector adecuado prueba tanto el patrón normal como el invertido, así que claro sobre oscuro (código blanco sobre fondo negro) debería seguir funcionando.
4. Brillos, reflejos o luz irregular
Fotografiar un código en una superficie brillante o una pantalla a menudo pone un punto de luz justo sobre el patrón, borrando parte de él. Las tomas de pantalla a pantalla también captan interferencia de muaré.
Solución: cambia el ángulo para matar el reflejo y busca luz uniforme en lugar de un único punto brillante. Si el código está en tu propia pantalla, sáltate la cámara por completo: haz una captura y decodifica la imagen directamente.
5. El código está dañado o parcialmente cubierto
Los códigos QR tienen corrección de errores y pueden sobrevivir a algún daño, pero un arañazo grande, un pliegue sobre un código impreso, una pegatina o un dedo cubriendo una esquina pueden llevarlo más allá de lo recuperable. Los tres grandes cuadrados de posición de las esquinas especialmente necesitan estar intactos.
Solución: si es físico, aplana un pliegue o limpia la superficie. Si de verdad falta una parte, ningún lector puede inventar los datos de vuelta: necesitarás una copia limpia del código.
Decodifica desde la imagen, no desde una cámara temblorosa
Si el código ya es un archivo —una captura, una foto guardada, un gráfico exportado—, no necesitas la cámara en absoluto. Leer directamente desde la imagen se salta por completo los problemas de enfoque y brillos.
El lector de códigos QR de IMG.DIY toma la imagen que le das, la decodifica en tu navegador y muestra el texto, probando automáticamente tanto el patrón normal como el invertido, y reduciendo las imágenes grandes para que se procesen rápido. Todo funciona localmente; nada se sube.
Un par de límites honestos para ajustar las expectativas: lee un código por imagen, así que si una foto contiene varios, recorta al que quieras. Y funciona a partir de una imagen, no de una webcam en vivo: una elección deliberada para mantenerse por completo local. Los códigos muy pequeños, borrosos o muy estilizados aún pueden resistirse incluso a un buen recorte; cuando eso pasa, la solución casi siempre es una captura más nítida, más cercana y de mayor contraste del código en lugar de otra herramienta.