Scanner e Decodificador de Códigos de Barras

Como funciona a decodificação por câmara e imagem

• Captura de frame: Quando pressiona Escanear, a app amostra um frame do seu fluxo de câmara ao vivo (ou da imagem que carregou).
• Detecção: Primeiro tentamos a Shape Detection API (BarcodeDetector) para detecção rápida no dispositivo. Se não for suportada ou se não encontrar nada, recorremos ao ZXing compilado para a web.
• Decodificação: A região detectada é processada para recuperar os dados codificados (dígitos UPC/EAN, texto Code 128/39, etc.).
• Resultados: A carga útil decodificada e o formato aparecem abaixo da pré-visualização. Pode copiar o texto instantaneamente.
• Privacidade: Todo o processamento é local — nenhuma imagem ou frame de vídeo sai do seu dispositivo.

Formatos de Códigos de Barras Suportados

Dicas para digitalização com a câmara

• Ilumine o código, não a lente: Use luz forte e difusa vinda de lado para evitar reflexos. Incline etiquetas brilhantes ou mova a fonte de luz para prevenir branqueamento.
• Use a lanterna quando necessário: Em telemóveis, active a luz quando estiver escuro. Incline ligeiramente o dispositivo para reduzir o brilho.
• Mantenha a distância certa: Aproxime-se até o código preencher 60–80% da vista. Muito longe = poucos pixels; muito perto = foco fraco.
• Foco e exposição: Toque no código para focar/autoexpor. Em muitos telemóveis, pressione longamente para bloquear AE/AF.
• A orientação importa para códigos 1D: Rote o dispositivo para que as barras corram horizontalmente no ecrã. Experimente 90° ou 180° se a detecção for difícil.
• Mantenha firme: Apoie os cotovelos, descanse sobre uma superfície ou use as duas mãos. Uma pausa de meio segundo melhora os resultados.
• Atente à margem branca: Deixe uma fina margem branca à volta do código — não recorte até às barras.
• Reduza inclinações e curvaturas: Mantenha o código plano e a câmara paralela. Para etiquetas curvas, afaste-se para reduzir a distorção e depois recorte mais apertado.
• Prefira a câmara principal: Evite lentes ultra-grandes para códigos pequenos; use a câmara principal (1×) ou telefoto.
• Evite modos que alterem a imagem: Desative modos Retrato/Beleza/HDR/motion-blur que possam suavizar barras finas.
• Limpe a lente: Impressões digitais e pó reduzem nitidez e contraste.
• Para códigos QR: Mantenha todo o quadrado (com a margem) visível e relativamente alinhado; evite recortar os cantos de referência.

Melhores resultados ao carregar imagens

• Use formatos adequados: PNG preserva bordas nítidas; JPEG é aceitável com qualidade alta (≥ 85). Converta HEIC/HEIF para PNG ou JPEG antes de carregar.
• A resolução importa: Etiquetas pequenas: ≥ 1000×1000 px. Códigos maiores: ≥ 600×600 px. Evite zoom digital — aproxime-se e recorte.
• Mantenha nítido: Apoie o telemóvel, toque para focar e faça uma pausa. Desfoque por movimento destrói barras finas e módulos QR.
• Recorte com margem branca: Recorte em torno do código mas deixe uma fina margem branca; não recorte nas barras/módulos.
• Corrija a orientação: Se a imagem estiver de lado/invertida, rode-a primeiro — a rotação EXIF nem sempre é respeitada.
• Controle a iluminação: Use luz forte e difusa; incline ligeiramente para retirar reflexos de etiquetas brilhantes.
• Aumente o contraste (se necessário): Converta para tons de cinzento e aumente o contraste. Evite filtros pesados/redução de ruído que esbatam bordas.
• Achate e desentorte: Para embalagens curvas, afaste-se, alinhe ao código e depois recorte mais apertado.
• Um código de cada vez: Se a foto tiver vários códigos de barras, recorte para o código alvo único.
• Preserve o original: Carregue o ficheiro original. Apps de mensagens frequentemente comprimem e adicionam artefactos.
• A partir de ecrãs: Prefira capturas de ecrã diretas. Se fotografar um ecrã, reduza ligeiramente o brilho para minimizar banding.
• Experimente outro dispositivo ou lente: Use a câmara principal (1×) para melhor detalhe; ultra-wide pode prejudicar a decodificação.

Solução de problemas em falhas de decodificação

• Confirme a simbologia: Suportados: EAN-13/8, UPC-A/E, Code 128, Code 39, ITF, Codabar e QR. Não suportados: Data Matrix, PDF417.
• Tente diferentes orientações: Rote o código ou dispositivo em passos de 90°. Para códigos 1D, barras horizontais são mais fáceis.
• Recorte de forma mais inteligente: Recorte em torno do código mantendo uma fina margem branca. Não recorte nas barras.
• Aumente o contraste: Melhore a iluminação, evite reflexos, procure barras escuras sobre fundo claro; para uploads, tente tons de cinzento com maior contraste.
• Cuidado com cores invertidas: Se as barras forem claras sobre fundo escuro, fotografe novamente com mais luz ou inverta as cores antes de carregar.
• Aumente a resolução utilizável: Aproxime-se, use uma foto de maior resolução ou mude para uma câmara melhor.
• Reduza inclinação/curvatura: Achate a etiqueta, alinhe a câmara ao código ou afaste-se, depois recorte mais apertado.
• Verifique qualidade de impressão e margem: Borrões, riscos ou margens ausentes podem impedir a decodificação. Tente uma amostra mais limpa.
• Valide regras de dados quando relevante: Alguns formatos têm restrições (por ex., ITF números pares; Code 39 com caracteres limitados). Verifique se o código segue as regras.
• Variabilidade do dispositivo/navegador: Tente outro dispositivo ou navegador. Active a lanterna; toque para focar e mantenha estável.
• Uploads de imagem — orientação/processamento: Rode fotos de lado antes de carregar. Evite filtros pesados ou redução de ruído.
• Ainda com problemas? Tente um recorte mais apertado, melhor iluminação e um segundo dispositivo. O código pode estar danificado ou não ser suportado.

Privacidade e processamento no dispositivo

Este scanner corre inteiramente no seu navegador: frames de câmara e imagens carregadas nunca saem do seu dispositivo. Use-o instantaneamente — sem registo e sem pixels de rastreio. Após o carregamento inicial, muitos navegadores conseguem executar esta ferramenta mesmo com ligação intermitente ou offline.