Dostosuj kiosk

Kiosk może drukować fizyczne bilety na drukarce ESC/POS. Bilety zawierają nazwę organizacji, nazwę lokalizacji, nazwę kolejki, numer biletu oraz tekst nagłówka i stopki skonfigurowany dla lokalizacji.

Wymagania

Drukowanie wymaga natywnej aplikacji kiosku. Wdrożenia kiosku działające wyłącznie w przeglądarce nie obsługują drukowania: pokazują każdy numer biletu na ekranie wraz z kodem QR dla telefonu (zobacz Śledzenie biletu na telefonie). Obsługiwane połączenia zależą od aplikacji:

Aplikacja	Sieć	USB	Bluetooth
Aplikacja kiosku na Androida	Tak	Tak	Tak
Desktopowy klient kiosku (macOS, Windows, Linux)	Tak	Tak	Nie

Drukowanie przez USB na komputerze wymaga dodatkowej konfiguracji na Windows i Linuksie. Zobacz Drukarki USB (komputer).

Bilety drukuje tylko kiosk. Stanowisko obsługi nie drukuje; pokazuje baner, gdy drukarka kiosku w lokalizacji jest offline.

Skonfiguruj drukarkę

Po sparowaniu nowego kiosku na Androidzie lub na komputerze kiosk otwiera konfigurację drukarki, o ile żadna drukarka nie jest jeszcze skonfigurowana. Ekran pokazuje drukarki znalezione przez kiosk, z oznaczeniem typu połączenia każdej z nich, oraz formularz dodawania drukarki sieciowej według adresu.

W sekcji Tryb językowy drukarki wybierz tryb obsługiwany przez drukarkę. Większość drukarek używa trybu Zachodnioeuropejski (CP858). Tryb Chiński uproszczony (Epson GB18030) wybierz tylko dla drukarki, która go obsługuje.
Wybierz drukarkę w jeden z tych sposobów:
- W sekcji Dostępne drukarki wybierz drukarkę i dotknij Połącz. Jeśli drukarki nie ma na liście, dotknij Szukaj drukarek.
- W sekcji Dodaj drukarkę sieciową ręcznie wpisz adres IP drukarki i dotknij Połącz.
Kiosk łączy się z drukarką i automatycznie drukuje bilet testowy. Nie ma osobnego kroku testu ani zapisu.
Sprawdź bilet testowy. Jeśli wydrukował się poprawnie, dotknij Tak, kontynuuj. Kiosk otwiera ekran kolejki. Jeśli nie, dotknij Nie, spróbuj ponownie. Kiosk usuwa tę drukarkę i wraca do listy, aby można było wybrać ponownie.

Jeśli nie znaleziono żadnej drukarki, ekran pokazuje Nie znaleziono drukarek. Podłącz lub sparuj drukarkę, a następnie dotknij Szukaj drukarek. Możesz też dodać drukarkę sieciową według adresu.

Drukarki sieciowe

Drukarka sieciowa musi mieć prywatny adres IPv4, na przykład 192.168.x.x, 10.x.x.x lub 172.16–31.x.x, i musi przyjmować połączenia na porcie 9100. Pole portu jest wypełnione wartością 9100 i nie przyjmuje innego portu. Nazwy hostów i adresy publiczne nie są akceptowane. Nadaj drukarce stały adres w swojej sieci, aby kiosk mógł się z nią połączyć także po jej ponownym uruchomieniu.

Drukarki USB (komputer)

Desktopowy klient kiosku wysyła bilety do drukarki USB bezpośrednio, a nie przez sterownik drukarki systemu operacyjnego. Sprawdź wymagania dla swojego systemu operacyjnego:

Windows — drukarka musi używać sterownika WinUSB. Windows zwykle instaluje własny sterownik drukowania USB lub sterownik producenta, a kiosk nie może otworzyć drukarki, która używa któregokolwiek z nich. Zastąp sterownik drukarki sterownikiem WinUSB za pomocą narzędzia takiego jak Zadig. Po tej zmianie inne aplikacje Windows nie mogą drukować na tej drukarce.
Linux — konto, na którym działa kiosk, musi mieć dostęp do urządzenia USB drukarki. Uruchom lsusb, aby znaleźć identyfikatory producenta i produktu drukarki. Utwórz plik /etc/udev/rules.d/70-jonot-printer.rules z poniższym wierszem, wstawiając identyfikatory swojej drukarki w miejsce 04b8 i 0202. Następnie uruchom sudo udevadm control --reload-rules i podłącz drukarkę ponownie.
```
SUBSYSTEM=="usb", ATTR{idVendor}=="04b8", ATTR{idProduct}=="0202", TAG+="uaccess"
```
macOS — konfiguracja sterownika nie jest potrzebna. Drukowanie przez USB na macOS nie zostało jeszcze sprawdzone na prawdziwej drukarce.

Jeśli drukarka jest na liście, ale bilet testowy się nie drukuje, najpierw sprawdź te wymagania.

Jeśli kiosk zgłasza drukarkę USB jako niedostępną po podłączeniu drugiej drukarki tego samego modelu lub po skopiowaniu ustawień kiosku na inny komputer, otwórz menu menedżera i wybierz Zmień drukarkę.

Drukarki Bluetooth (Android)

Sparuj drukarkę w ustawieniach Bluetooth Androida, zanim skonfigurujesz ją w kiosku. Jeśli drukarki nie ma na liście, dotknij Otwórz ustawienia Bluetooth, sparuj drukarkę, wróć do kiosku i dotknij Szukaj drukarek. Domyślnie lista pokazuje tylko sparowane urządzenia, które identyfikują się jako drukarki. Jeśli drukarka jest sparowana, ale nie ma jej na liście, wybierz Pokaż wszystkie sparowane urządzenia. Lista pokazuje wtedy wszystkie sparowane urządzenia i oznacza te, które nie identyfikują się jako drukarki.

W Androidzie 12 i nowszych Android prosi o uprawnienie do łączenia się z urządzeniami w pobliżu, gdy konfiguracja drukarki po raz pierwszy wyszukuje drukarki. Jeśli uprawnienie zostanie odrzucone, konfiguracja drukarki pokazuje komunikat. Aby to naprawić, otwórz Ustawienia Androida, przejdź do Aplikacje → Jonot Kiosk → Uprawnienia i przyznaj uprawnienie. Następnie wróć do konfiguracji drukarki.

Kiosk na Androidzie nie przechodzi w zablokowany tryb kiosku, dopóki drukarka nie zostanie podłączona, więc podczas konfiguracji możesz otworzyć ustawienia Androida.

Zmień drukarkę

Otwórz menu menedżera: pięć szybkich dotknięć w prawym górnym rogu (każde w ciągu ok. 1,5 sekundy od poprzedniego), a następnie wpisz PIN menedżera. Pełny gest opisuje Wyjście z blokady kiosku.
Wybierz Zmień drukarkę, aby ponownie otworzyć konfigurację drukarki. Na Androidzie potwierdź komunikat pokazujący bieżącą drukarkę.
Konfiguracja drukarki pokazuje bieżącą drukarkę. Kiosk zachowuje bieżącą drukarkę, dopóki nie podłączysz nowej. Aby ją zachować, dotknij Anuluj — zachowaj obecną drukarkę.
Skonfiguruj nową drukarkę zgodnie z opisem w sekcji Skonfiguruj drukarkę.

Na Androidzie zablokowany kiosk nie może otworzyć ustawień Androida. Aby przejść na drukarkę Bluetooth, która nie jest jeszcze sparowana, otwórz menu menedżera i wybierz Zakończ. Sparuj drukarkę w ustawieniach Bluetooth Androida, ponownie otwórz kiosk, a następnie wybierz Zmień drukarkę.

Jeśli po podłączeniu nowej drukarki dotkniesz Nie, spróbuj ponownie, kiosk nie ma drukarki, dopóki jej nie skonfigurujesz. Jeśli wcześniej do kolejki dołączy klient, kiosk przejdzie w tryb niesprawnej drukarki.

Zawartość biletu

Każdy wydrukowany bilet zawiera:

Nazwę organizacji
Nazwę lokalizacji
Nazwę kolejki
Numer biletu (duży, wyeksponowany)
Nagłówek biletu (do 48 znaków) — skonfigurowany dla lokalizacji w panelu administracyjnym
Stopkę biletu (do 48 znaków) — skonfigurowaną dla lokalizacji w panelu administracyjnym

Aby zmienić tekst nagłówka lub stopki, przejdź w panelu administracyjnym do swojej lokalizacji → Edytuj lokalizację.

Ponowny wydruk biletu

Po udanym wydruku kiosk pokazuje przez około 30 sekund przycisk Wydrukuj bilet ponownie. Dotknij go, aby wysłać do drukarki dokładną kopię biletu — z tym samym numerem, nagłówkiem, stopką i znacznikiem czasu. Skorzystaj z tej opcji, gdy bilet się zatnie albo klient potrzebuje drugiej kopii.

Ponowny wydruk wydłuża odliczanie do automatycznego zamknięcia, aby klient zdążył odebrać nowy bilet.
Jeśli ponowny wydruk się nie powiedzie, kiosk pokazuje kartę niedostępności drukarki i może przejść w tryb niesprawnej drukarki.
Każdy ponowny wydruk jest osobnym zadaniem druku z własnym identyfikatorem.

Śledzenie biletu na telefonie

Gdy klient dołączy do kolejki, karta biletu pokazuje nagłówek Śledź swoje miejsce w kolejce na telefonie i kod QR tego biletu. Kod pojawia się niezależnie od tego, czy bilet się wydrukował. Klient skanuje go aparatem telefonu, a przeglądarka telefonu otwiera ten sam bilet, dzięki czemu klient może śledzić swoje miejsce w kolejce. Zeskanowanie kodu nigdy nie tworzy drugiego biletu: klient zachowuje ten sam numer.

Kod jest widoczny przez 30 sekund. Każde dotknięcie przycisku Więcej czasu dodaje 30 sekund, maksymalnie 10 razy. Gdy zostaje 20 sekund, karta ostrzega, że kod wkrótce zniknie. Inne dotknięcia ekranu nie wydłużają czasu kodu.
Na karcie sukcesu dotknięcie poza kartą zamyka kartę, co ukrywa także kod.
Gdy telefon otworzy bilet, kod znika, a kiosk potwierdza, że bilet został otwarty na telefonie.
Kod znika także wtedy, gdy klient dotknie przycisku Gotowe, gdy karta wraca do ekranu głównego, gdy dołącza kolejny klient i gdy kiosk traci połączenie z Jonot. Ukryty kod nie pojawia się ponownie dla tego biletu.
Telefon, który otworzy kod po utracie jego ważności, pokazuje komunikat Ten kod jest już nieważny. Telefon nie proponuje ponownego dołączenia do kolejki, więc klient zachowuje posiadany bilet.
Jeśli kiosk nie jest połączony z Jonot, gdy klient dołącza do kolejki, karta pokazuje numer biletu bez kodu.

Kod otwiera stronę biletu z takim samym dostępem jak własny link klienta do biletu, łącznie z anulowaniem biletu. Telefon, który otworzy kod, może wyświetlać i anulować ten bilet do jego zakończenia. Kod działa jeszcze przez krótki czas po zniknięciu i może go otworzyć więcej niż jeden telefon. Dlatego kod jest widoczny tylko przez krótki czas.

Klient bez telefonu zachowuje wydrukowany bilet. Jeśli bilet się nie wydrukował, członek personelu zapisuje numer dla klienta.

Kod QR na ekranie głównym to inny kod. Pozwala klientowi, który jeszcze nie dołączył do kolejki, dołączyć z telefonu.

Automatyczny powrót do ekranu głównego

Kiosk wraca do ekranu głównego po okresie bezczynności:

Karta sukcesu — zamyka się 30 sekund po ostatnim dotknięciu lub po dotknięciu przez klienta przycisku Wydrukuj bilet ponownie.
Karta błędu — zamyka się po 45 sekundach. Gdy bilet nie zostanie wydrukowany, ta karta pokazuje Bilet wydany — drukarka niedostępna i numer biletu oraz prosi klienta, aby członek personelu zapisał numer.

Gdy kod QR dla telefonu jest widoczny, żadna z kart nie zamyka się samoczynnie przed zniknięciem kodu.

Odliczanie zatrzymuje się, gdy aplikacja przechodzi w tło, i wznawia się, gdy wraca na pierwszy plan. Krótkie wygaszenie ekranu nie resetuje odliczania w trakcie obsługi. To zachowanie jest zawsze aktywne i nie wymaga konfiguracji.

Język klienta

Gdy Twoja organizacja lub lokalizacja oferuje więcej niż jeden język, każdy klient może wybrać w kiosku język na czas swojej interakcji. Gdy kiosk wraca do ekranu głównego, ustawia z powrotem domyślny język lokalizacji dla kolejnej osoby. Dostępne języki i język domyślny ustawisz w panelu administracyjnym; zobacz Języki.

Niesprawna drukarka

Jeden nieudany wydruk lub ponowny wydruk biletu przełącza kiosk w tryb niesprawnej drukarki. Dotyczy to także drukarki wyłączonej, odłączonej lub nieosiągalnej, kiosku z wyłączonym Bluetooth oraz kiosku bez skonfigurowanej drukarki. Nie liczą się błędy, które nic nie mówią o drukarce: kiosk w przeglądarce, który nie ma połączenia z drukarką, zadanie druku, które już trwa, lub bilet, który kiosk odrzuca, zanim trafi on do drukarki, na przykład dlatego, że zawiera znaki, których drukarka nie potrafi wydrukować, albo jest za duży. Kiosk nie wykrywa pustej rolki papieru: drukarka zwykle przyjmuje bilet, więc kiosk pokazuje go jako wydrukowany.

Jeśli drukarka nie odpowie w ciągu 8 sekund, kiosk pokazuje kartę niedostępności drukarki i czeka jeszcze do 30 sekund. Jeśli w tym czasie bilet się wydrukuje, kiosk pozostaje w zwykłym trybie. Nieudany bilet testowy podczas konfiguracji drukarki sam nie zmienia trybu.

W trybie niesprawnej drukarki:

Klienci nadal mogą dołączać do kolejki. Kiosk nie próbuje drukować. Pokazuje numer biletu na karcie z nagłówkiem Bilet wydany — drukarka niedostępna wraz z kodem QR dla telefonu. Klient bez telefonu prosi członka personelu o zapisanie numeru.
Ekran główny pokazuje baner informujący, że drukarka biletów jest niesprawna, a tekst nad przyciskiem Drukuj bilet wyjaśnia, że bilet nie zostanie wydrukowany. Etykieta przycisku się nie zmienia.
Kiosk zapisuje tryb na urządzeniu, więc tryb pozostaje włączony po przeładowaniu lub ponownym uruchomieniu aplikacji kiosku.
Stanowisko obsługi pokazuje baner o drukarce offline dla tego kiosku, a panel administracyjny pokazuje drukarkę jako Offline. Kiosk ponownie zgłasza usterkę przy każdym załadowaniu i za każdym razem, gdy klient dołącza do kolejki. Jeśli przez 24 godziny nie nastąpi żadne z tych zdarzeń, stanowisko obsługi przestaje pokazywać baner, ale kiosk pozostaje w trybie niesprawnej drukarki.

Tryb niesprawnej drukarki może zakończyć tylko personel, za pomocą biletu testowego:

Sprawdź papier, zasilanie i połączenie drukarki.
Otwórz menu menedżera i wybierz Zmień drukarkę. Zobacz Zmień drukarkę.
Podłącz drukarkę. Kiosk drukuje bilet testowy. Powolna drukarka może potrzebować jeszcze do 30 sekund, więc poczekaj na wynik.
Jeśli bilet testowy wydrukował się poprawnie, dotknij Tak, kontynuuj.

Tryb kończy się tylko wtedy, gdy kiosk pomyślnie wyśle bilet testowy do drukarki, a Ty potwierdzisz, że wydrukował się poprawnie. Jeśli kiosk nie mógł wysłać biletu testowego do drukarki, pozostaje w trybie niesprawnej drukarki i zamiast przycisku Tak, kontynuuj wyświetla przycisk Wydrukuj wydruk testowy ponownie. Dotknięcie przycisku Anuluj — zachowaj obecną drukarkę pozostawia kiosk w trybie niesprawnej drukarki. Klient nigdy nie musi pobierać biletu, aby przetestować drukarkę.

Status drukarki w panelu administracyjnym

Bieżący status drukarki jest widoczny w panelu administracyjnym w zakładce Urządzenia lokalizacji. Status pokazuje:

Połączona — ostatni bilet lub bilet testowy wydrukował się poprawnie.
Offline — ostatnia próba druku nie powiodła się, z krótkim powodem.

Jeśli drukarka pokazuje błąd, sprawdź połączenie sieciowe, USB lub Bluetooth i upewnij się, że drukarka ma papier. Status wraca do Połączona po następnym udanym wydruku. W trybie niesprawnej drukarki kiosk nie drukuje biletów, więc status wraca dopiero wtedy, gdy udany bilet testowy zakończy ten tryb.