Decodificador de Códigos QR

Acerca del Decodificador de Códigos QR

El Decodificador de Códigos QR lee los datos ocultos dentro de un código QR (Quick Response), el patrón cuadrado en blanco y negro que ves en pósteres, tarjetas de visita, menús de restaurantes, embalajes, pantallas de pago y entradas de eventos. Puedes subir una foto que contenga un QR o apuntar la cámara de tu dispositivo a uno, y la herramienta extrae el contenido textual, que con mayor frecuencia es una URL, pero también puede ser credenciales Wi-Fi, una tarjeta vCard, un email, un SMS, un evento de calendario, coordenadas de geolocalización o texto arbitrario. La decodificación ocurre completamente en tu navegador mediante la biblioteca de código abierto jsQR, que implementa el estándar ISO/IEC 18004: localiza los tres cuadrados grandes de búsqueda en las esquinas, calcula la transformación de perspectiva, muestrea los módulos de datos y ejecuta la corrección de errores Reed-Solomon para recuperar los bytes originales incluso si parte del código está sucio o parcialmente cubierto. No se sube ningún dato a ningún servidor, lo que hace que la herramienta sea segura para QR que contengan información personal como tokens de pago, contraseñas Wi-Fi o URL privadas. Se admiten tanto la Versión 1 (21 x 21) como la mayor Versión 40 (177 x 177), incluidos los cuatro niveles de corrección de errores L / M / Q / H.

¿Qué hace este decodificador de QR?

Toma una imagen que tú subes o el video en vivo de la cámara, encuentra cualquier código QR presente en el cuadro e imprime el texto o URL original que fue codificado dentro. Internamente implementa la especificación QR ISO/IEC 18004: detecta los tres patrones de búsqueda de esquina, calcula una deformación de perspectiva a una rejilla perfecta, lee los módulos de datos, aplica la máscara de formato y ejecuta la corrección de errores Reed-Solomon (que permite que los QR sigan funcionando aun cuando hasta el 30 % de la superficie esté dañada o cubierta, según el nivel de corrección elegido al codificar). El contenido decodificado suele ser una URL, pero también puede ser credenciales Wi-Fi, contactos vCard, correo, SMS, geolocalización, eventos de calendario o texto plano.

¿Qué tipos de archivo y formatos QR se admiten?

Cualquier formato de imagen rasterizada que tu navegador pueda decodificar: JPG, JPEG, PNG, GIF (primer fotograma), BMP y WebP, además de HEIC en Safari. No hay un límite fijo de tamaño ya que nada se sube, pero la herramienta redimensiona imágenes de más de 1600 píxeles por lado para acelerar la decodificación. Se admiten tanto la Versión 1 (21 x 21 módulos) como la mayor Versión 40 (177 x 177 módulos), los cuatro niveles de corrección de errores (L 7%, M 15%, Q 25%, H 30%), todos los patrones de máscara y los modos estándar byte/UTF-8 y Kanji. Los QR invertidos (blanco sobre negro) también se detectan automáticamente con una segunda pasada.

¿El decodificador sube mi imagen o usa el material de mi cámara?

No. La imagen que cargas se dibuja en un Canvas dentro de la página y se decodifica con la biblioteca jsQR ejecutándose en el motor JavaScript del navegador; la pestaña de la cámara usa getUserMedia para acceder al flujo en vivo localmente y nunca graba ni transmite los fotogramas. Puedes verificarlo en la pestaña Red del navegador: tras cargar la página, el escaneo no produce ninguna petición saliente con datos de imagen. Esto hace que la herramienta sea segura para códigos QR con información sensible como contraseñas Wi-Fi domésticas, secretos de autenticación de dos factores, URL de pago o tarjetas de embarque. El permiso de cámara solo lo pide el navegador para acceder a la cámara del dispositivo; puedes revocarlo en cualquier momento en la configuración del sitio.

¿Por qué falló la decodificación o devolvió un texto erróneo?

Los QR son tolerantes pero no mágicos. Causas habituales de fallo son: ángulo extremo (más de 45 grados respecto a la perpendicular), desenfoque por movimiento, contraste pobre (papel desgastado, brillos en la pantalla del teléfono), que el código ocupe menos de unos 100 píxeles por lado en la foto, esquinas dañadas o ausentes, y reflejos que crucen la cuadrícula de datos. Prueba con una foto más limpia donde el código esté centrado, bien iluminado, enfocado y ocupando al menos un tercio del cuadro. Para códigos muy pequeños dentro de una foto grande, recórtala antes. Las cámaras funcionan mejor cuando el QR llena la mayor parte del visor y mantienes el dispositivo quieto un par de segundos. Si un código devuelve texto ilegible, puede estar usando una codificación no estándar, como Shift-JIS Kanji en un póster japonés.

¿Qué navegadores y dispositivos son compatibles?

El decodificador funciona en cualquier navegador moderno con HTML5 Canvas y JavaScript ES2017: Chrome, Edge, Firefox, Safari, Opera y Samsung Internet, tanto en escritorio como en móvil. La pestaña de cámara necesita la API getUserMedia y que la página se sirva por HTTPS (el sitio de WuTools lo es), algo que cubren todos los navegadores modernos. En iOS la cámara funciona en Safari desde la versión 11. La biblioteca jsQR pesa solo unos 50 KB comprimidos, así que la herramienta carga casi instantáneamente incluso con conexiones móviles lentas. No hay requisitos mínimos de hardware más allá de tener RAM suficiente para una imagen; un móvil de hace cinco años la ejecuta sin problemas.

¿Puede el decodificador leer varios QR en una imagen a la vez?

La implementación actual lee un código QR por imagen: devuelve el primer código válido que detecta tras la búsqueda de esquinas. Si tienes una hoja con varios QR, recorta y escanea uno por uno, o usa el modo cámara apuntando a cada código. Consideraremos añadir soporte para varios códigos en una futura actualización; el algoritmo subyacente jsQR puede ejecutarse en regiones superpuestas, pero añade complejidad y tiempo de ejecución. Ten en cuenta que otros códigos 2D como Data Matrix, Aztec, MaxiCode o PDF417 usan algoritmos distintos y no se manejan con un decodificador solo de QR; para ellos necesitarías una biblioteca más general.