Aby skaner mógł użyć kamery, muszą zostać spełnione trzy warunki: portal otwarty po HTTPS, przeglądarka uzyskała pozwolenie od użytkownika, a w iOS — skaner uruchamia się tylko po naciśnięciu przycisku. Jeśli coś jest nie tak — skaner się nie otwiera lub pokazuje czarny ekran. Tutaj szczegółowo o każdym warunku.
Warunek 1: HTTPS jest obowiązkowy
Nowoczesne przeglądarki (Chrome, Firefox, Safari, Edge, Samsung Internet) zezwalają na dostęp do kamery tylko na stronach z zabezpieczonym połączeniem — to znaczy, że pasek adresu musi zaczynać się od https:// i zwykle zawierać ikonę kłódki.
Jeśli Twój portal jest otwarty po http:// (bez „s") — skaner nie wystartuje. To nie ustawienie portalu, to wymóg przeglądarki, nie da się go obejść. Skontaktuj się z administratorem firmy — musi on skonfigurować certyfikat SSL dla domeny portalu.
Wyjątek: dla potrzeb deweloperskich przeglądarki zezwalają na dostęp do kamery na http://localhost i http://127.0.0.1. Ale to nie pomaga zwykłym użytkownikom — oni zawsze mają pełną domenę.
Warunek 2: Pozwolenie od użytkownika
Przy pierwszym naciśnięciu przycisku skanera przeglądarka pokazuje wyskakujące zapytanie: „{strona} chce użyć kamery" z dwoma przyciskami „Zezwól" / „Zablokuj".
- Naciśnięto „Zezwól" — przeglądarka zapamięta wybór, w dalszej kolejności skaner będzie się otwierał od razu.
- Naciśnięto „Zablokuj" — przeglądarka też zapamięta, i przy kolejnych próbach skaner cicho nie będzie działał (zapytanie już nie pojawi się automatycznie).
- Zamknięto okno (swipe / tap obok) — zwykle równoznaczne z „odłożenie decyzji", przy następnej próbie zapytanie pojawi się ponownie.
Jak zmienić decyzję, jeśli przypadkowo zablokowano
Chrome / Edge (Android, Windows, macOS):
- Naciśnij ikonę kłódki po lewej od adresu portalu.
- Otworzy się lista uprawnień; znajdź „Kamera".
- Zmień wartość z „Blokuj" na „Zezwól".
- Przeładuj stronę.
Safari (iOS):
- Otwórz Ustawienia iOS → Safari → Kamera.
- Znajdź swoją domenę na liście i zmień na „Zezwól" lub „Pytaj".
Firefox:
- Ikona tarczy lub kłódki po lewej od adresu.
- „Uprawnienia" → „Użyj kamery" → „Pytaj" lub „Zezwól".
Warunek 3: iOS Safari — tylko po naciśnięciu przycisku
Na iPhone i iPad skaner nie uruchamia się „sam", nawet jeśli ma uprawnienia i HTTPS działa. Przeglądarka zezwala na dostęp do kamery tylko z handlera gestu użytkownika — to znaczy po faktycznym tapnięciu w przycisk. Dlatego:
- Skaner zawsze uruchamia się tapnięciem przycisku w nagłówku portalu, żadnych automatycznych wyskakujących okien przy ładowaniu strony.
- Jeśli na stronie jest logika JavaScript, która „otwiera skaner od razu po pojawieniu się" — w iOS to nie zadziała, i tak trzeba nacisnąć przycisk.
Prywatność: co dzieje się z wideo
- Wideo nie jest przesyłane na serwer. Rozpoznawanie QR odbywa się lokalnie w przeglądarce — klatki są przetwarzane w pamięci urządzenia i od razu usuwane.
- Na serwer trafia tylko wynik — rozpoznany ciąg (zawartość kodu QR).
- Wideo nie jest nagrywane. Jak tylko okno skanera zostało zamknięte, strumień z kamery się zatrzymuje, wskaźnik kamery w systemie gaśnie.
- W tle kamera nie działa — portal nie ma dostępu do kamery, gdy okno skanera jest zamknięte.
Jeśli innych problemów nie ma, a skaner i tak nie działa
Patrz oddzielny artykuł „Rozwiązywanie problemów ze skanerem".