Leitor e Decodificador de Códigos de Barras

Como Funciona a Decodificação por Câmera e Imagem

• Captura do quadro: Quando pressiona Digitalizar, a aplicação captura um quadro do fluxo de vídeo da sua câmera (ou da imagem que você carregou).
• Deteção: Tentamos primeiro a Shape Detection API (BarcodeDetector) para deteçã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 detetada é 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ódigo de Barras Suportados

Dicas para Digitalização com a Câmera

• Ilumine o código, não a lente: Use luz forte e difusa vinda de lado para evitar brilho e reflexos. Incline etiquetas brilhantes ou mova a luz para evitar ofuscamento.
• Use a lanterna quando necessário: Em telemóveis, ative o flash em ambientes com pouca luz. Incline ligeiramente o aparelho para reduzir reflexos.
• Mantenha a distância certa: Aproxime até que o código ocupe 60–80% da visualização. Muito longe = poucos pixels; muito perto = foco ruim.
• Foco e exposição: Toque no código para focar/ativar autoexposição. Pressionar longamente em muitos telemóveis bloqueia AE/AF.
• A orientação importa para códigos 1D: Rote para que as barras corram horizontalmente pela tela. Tente 90° ou 180° se a deteção for dificultada.
• Mantenha firme: Apoie os cotovelos, encoste num suporte ou use as duas mãos. Uma pausa de meio segundo melhora os resultados.
• Respeite a zona tranquila: Deixe uma margem branca fina em torno do código—não crop até às barras.
• Reduza inclinação e curvatura: Mantenha o código plano e a câmera paralela. Para etiquetas curvas, afaste-se para reduzir distorção e depois recorte mais apertado.
• Prefira a câmara principal: Evite lentes ultra-wide 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 podem 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 zona tranquila) visível e relativamente direito; evite cortes parciais dos cantos de referência.

Melhores Resultados ao Carregar Imagens

• Use formatos adequados: PNG preserva bordas nítidas; JPEG serve bem em alta qualidade (≥ 85). Converta HEIC/HEIF para PNG ou JPEG antes de enviar.
• 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. Borrão de movimento destrói barras finas e módulos QR.
• Recorte com zona tranquila: Recorte em torno do código, mas deixe uma margem branca fina; não recorte barras/módulos.
• Corrija a orientação: Se a imagem estiver de lado/invertida, rode-a primeiro—rotina EXIF nem sempre é respeitada.
• Controle a iluminação: Use luz forte e difusa; incline ligeiramente para afastar o brilho de etiquetas brilhantes.
• Aumente o contraste (se necessário): Converta para tons de cinza e aumente o contraste. Evite filtros pesados/redução de ruído que borram bordas.
• Achate e desinforme: Para embalagens curvas, afaste-se, alinhe ao código e depois recorte mais apertado.
• Um código de cada vez: Se uma foto tiver múltiplos códigos de barras, recorte para o código alvo.
• Preserve o original: Carregue o ficheiro original. Aplicações de mensagens costumam comprimir e adicionar artefactos.
• De ecrãs: Prefira capturas de ecrã diretas. Se fotografar um display, reduza um pouco o brilho para reduzir bandas.
• Tente outro dispositivo ou lente: Use a câmara principal (1×) para melhores detalhes; ultra-wide pode prejudicar a decodificação.

Resolução de Falhas de Decodificação

• Confirme a simbologia: Suportado: EAN-13/8, UPC-A/E, Code 128, Code 39, ITF, Codabar e QR. Não suportado: Data Matrix, PDF417.
• Tente diferentes orientações: Rote o código ou o dispositivo em passos de 90°. Para códigos 1D, barras horizontais são mais fáceis.
• Recorte com mais critério: Recorte em torno do código mantendo uma fina zona branca. Não corte nas barras.
• Aumente o contraste: Melhore a iluminação, evite reflexos, prefira barras escuras em fundo claro; para uploads, tente tons de cinza com contraste maior.
• Cuidado com cores invertidas: Se as barras forem claras sobre fundo escuro, fotografe com mais luz ou inverta as cores antes de enviar.
• Aumente a resolução utilizável: Aproxime-se, use uma foto de maior resolução ou mude para uma câmera melhor.
• Reduza inclinação/curvatura: Achate a etiqueta, alinhe a câmera ao código ou afaste-se e depois recorte mais apertado.
• Verifique qualidade de impressão e zona tranquila: Borrões, riscos ou zonas tranquilas ausentes podem impedir a decodificação. Tente uma amostra mais limpa.
• Valide regras de dados quando relevantes: Alguns formatos têm restrições (ex.: ITF números pares; Code 39 caracteres limitados). Verifique se o código segue as suas regras.
• Variabilidade entre dispositivos/ navegadores: Tente outro dispositivo ou navegador. Ative a lanterna; toque para focar e mantenha estável.
• Uploads de imagem—orientação/processamento: Rode fotos de lado antes de enviar. 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 da câmera e imagens carregadas nunca saem do seu dispositivo. Use-o instantaneamente—sem registo e sem pixels de rastreamento. Após o carregamento inicial, muitos navegadores conseguem executar esta ferramenta mesmo com ligação intermitente ou offline.