Skaner i dekoder kodów kreskowych

Jak działa dekodowanie z kamery i obrazu

• Przechwytywanie klatki: Po naciśnięciu Skanuj aplikacja pobiera klatkę ze strumienia z kamery na żywo (lub z przesłanego obrazu).
• Wykrywanie: Najpierw próbujemy użyć Shape Detection API (BarcodeDetector) do szybkiego wykrywania na urządzeniu. Jeśli nie jest obsługiwane lub nic nie znajdzie, przechodzimy na ZXing skompilowany dla sieci.
• Dekodowanie: Wykryty obszar jest przetwarzany w celu odczytania zakodowanych danych (cyfry UPC/EAN, tekst Code 128/39 itd.).
• Wyniki: Zdekodowana zawartość i format pojawiają się pod podglądem. Możesz natychmiast skopiować tekst.
• Prywatność: Wszystkie operacje odbywają się lokalnie — żadne obrazy ani klatki wideo nie opuszczają Twojego urządzenia.

Obsługiwane formaty kodów kreskowych

Wskazówki przy skanowaniu aparatem

• Oświetl kod, nie obiektyw: Użyj jasnego, rozproszonego światła z boku, aby uniknąć odblasków i refleksów. Pochyl błyszczące etykiety lub przesuwaj źródło światła, aby zapobiec przepaleniom.
• Użyj latarki gdy potrzeba: Na telefonach włącz lampę błyskową w słabym oświetleniu. Uchyl urządzenie lekko, by zmniejszyć odblaski.
• Zachowaj odpowiednią odległość: Zbliż się, aż kod wypełni 60–80% widoku. Za daleko = za mało pikseli; za blisko = problemy z ostrością.
• Ostrość i ekspozycja: Dotknij kodu, aby ustawić ostrość/autoekspozycję. Przytrzymanie palca na wielu telefonach zablokuje AE/AF.
• Orientacja ma znaczenie dla kodów 1D: Obróć tak, by paski przebiegały poziomo na ekranie. Spróbuj 90° lub 180°, jeśli wykrywanie jest oporne.
• Utrzymaj stabilność: Podeprzyj łokcie, oprzyj się na powierzchni lub użyj dwóch rąk. Półsekundowa pauza poprawia wyniki.
• Zachowaj strefę ciszy: Zostaw cienki biały margines wokół kodu — nie przycinaj tuż przy paskach.
• Zmniejsz skośność i krzywiznę: Utrzymaj kod płasko i aparat równolegle. Dla krzywych etykiet cofnij się, by zmniejszyć zniekształcenia, a potem przytnij bliżej.
• Preferuj główną kamerę: Unikaj obiektywów ultraszerokokątnych dla małych kodów; użyj głównej (1×) lub teleobiektywu.
• Unikaj trybów zmieniających obraz: Wyłącz tryby Portret/Upiększanie/HDR/rozmycie ruchu, które mogą zmiękczać drobne paski.
• Wyczyść obiektyw: Odciski palców i kurz zmniejszają ostrość i kontrast.
• Dla kodów QR: Utrzymaj cały kwadrat (razem ze strefą ciszy) widoczny i mniej więcej prosty; unikaj częściowego przycinania rogów wzornika.

Najlepsze wyniki przy przesyłaniu obrazów

• Używaj odpowiednich formatów: PNG zachowuje ostre krawędzie; JPEG jest w porządku przy wysokiej jakości (≥ 85). Konwertuj HEIC/HEIF do PNG lub JPEG przed przesłaniem.
• Rozdzielczość ma znaczenie: Małe etykiety: ≥ 1000×1000 px. Większe kody: ≥ 600×600 px. Unikaj zoomu cyfrowego — podejdź bliżej i przytnij.
• Zadbaj o ostrość: Podeprzyj telefon, dotknij, by ustawić ostrość i zrób pauzę. Rozmycie ruchu niszczy cienkie paski i moduły QR.
• Przytnij z zachowaniem strefy ciszy: Przytnij wokół kodu, ale zostaw cienki biały margines; nie przycinaj pasków/modułów.
• Popraw orientację: Jeśli obraz jest bokiem/do góry nogami, obróć go najpierw — rotacja EXIF nie zawsze jest respektowana.
• Kontroluj oświetlenie: Użyj jasnego, rozproszonego światła; pochyl lekko, aby usunąć odblaski z błyszczących etykiet.
• Zwiększ kontrast (jeśli potrzeba): Konwertuj do skali szarości i podnieś kontrast. Unikaj ciężkich filtrów/redukcji szumów, które rozmazują krawędzie.
• Wypłaszcz i wyrównaj: Dla zakrzywionych opakowań cofnij się, ustaw kod na wprost, a potem przytnij bliżej.
• Jeden kod na raz: Jeśli na zdjęciu jest wiele kodów, przytnij do jednego docelowego kodu.
• Zachowaj oryginał: Prześlij oryginalny plik. Aplikacje do wiadomości często kompresują i dodają artefakty.
• Z ekranów: Wolisz bezpośrednie zrzuty ekranu. Jeśli fotografujesz wyświetlacz, zmniejsz nieco jasność, by zredukować pasmowanie.
• Spróbuj innego urządzenia lub obiektywu: Użyj głównej kamery (1×) dla najlepszych detali; ultraszerokie mogą pogorszyć odczytywalność.

Rozwiązywanie problemów z dekodowaniem

• Potwierdź symbolikę: Obsługiwane: EAN-13/8, UPC-A/E, Code 128, Code 39, ITF, Codabar i QR. Nieobsługiwane: Data Matrix, PDF417.
• Wypróbuj różne orientacje: Obróć kod lub urządzenie o kroki po 90°. Dla kodów 1D najłatwiej, gdy paski są poziome.
• Przycinaj mądrze: Przytnij wokół kodu, zachowując cienką białą strefę ciszy. Nie przycinaj pasków.
• Zwiększ kontrast: Popraw oświetlenie, unikaj odblasków, dąż do ciemnych pasków na jasnym tle; przy przesyłaniu spróbuj skali szarości z wyższym kontrastem.
• Uważaj na odwrócone kolory: Jeśli paski są jasne na ciemnym tle, zrób zdjęcie ponownie z lepszym światłem lub odwróć kolory przed przesłaniem.
• Zwiększ dostępną rozdzielczość: Zbliż się, użyj zdjęcia o wyższej rozdzielczości lub przejdź na lepsze urządzenie.
• Zredukuj skośność/krzywiznę: Wyrównaj etykietę, ustaw aparat prostopadle do kodu lub cofnij się, potem przytnij bliżej.
• Sprawdź jakość druku i strefę ciszy: Rozmazy, rysy lub brakujące strefy ciszy mogą uniemożliwić dekodowanie. Spróbuj czystszego egzemplarza.
• Weryfikuj reguły danych, gdy to istotne: Niektóre formaty mają ograniczenia (np. ITF parzysta liczba cyfr; Code 39 ograniczony zestaw znaków). Sprawdź, czy kod spełnia swoje reguły.
• Zmienność między urządzeniami/przeglądarkami: Wypróbuj inne urządzenie lub przeglądarkę. Włącz latarkę; dotknij, by ustawić ostrość i trzymaj stabilnie.
• Przesyłanie obrazów — orientacja/przetwarzanie: Obróć zdjęcia bokiem przed przesłaniem. Unikaj ciężkich filtrów lub redukcji szumów.
• Wciąż bez rezultatu? Spróbuj dokładniejszego przycięcia, lepszego oświetlenia i drugiego urządzenia. Kod może być uszkodzony lub nieobsługiwany.

Prywatność i przetwarzanie po stronie urządzenia

Ten skaner działa całkowicie w Twojej przeglądarce: klatki z kamery i przesłane obrazy nigdy nie opuszczają Twojego urządzenia. Używaj go od razu — bez rejestracji i bez pikseli śledzących. Po początkowym załadowaniu wiele przeglądarek potrafi uruchomić to narzędzie nawet przy niestabilnym połączeniu lub w trybie offline.