Pierwsze uruchomienie klienta - kreator i parowanie ekranu

Pierwsze uruchomienie klienta Ineris SMS Desktop to moment krytyczny — to wtedy łączysz fizyczny ekran z logiczną reprezentacją w panelu webowym. W tym artykule przejdziemy przez kreator krok po kroku, omawiając każde pole.

URUCHOMIENIE PO INSTALACJI

Po zakończeniu instalacji aplikacja uruchamia się automatycznie (jeśli zaznaczono w kreatorze) lub klikasz skrót na pulpicie / w menu Start. Po pierwsze pojawi się 3-sekundowy splash screen z logo Ineris. Następnie aplikacja przechodzi na pełny ekran i pokazuje kreator pierwszego uruchomienia. Jeśli komputer ma kilka monitorów, kreator pojawi się domyślnie na monitorze głównym — w kolejnym kroku wybierzesz, na którym monitorze ma docelowo działać aplikacja.

KROK 1 KREATORA — ADRES SERWERA

Pierwsze pole to adres URL Twojego panelu webowego, np. https://sms.ineris.pl/app lub https://twoja-firma.pl/sms. To adres, pod którym widzisz panel administracyjny — bez końcowego ukośnika ani strony logowania. Aplikacja użyje go do wszystkich połączeń API: pobierania konfiguracji, synchronizacji audio, sprawdzania aktualizacji. Pole jest wypełnione domyślnie wartością z konfiguracji instalatora — zwykle pozostaw bez zmian, chyba że wiesz że masz inny adres.

KROK 2 KREATORA — KOD AUTORYZACYJNY EKRANU

Drugie pole to 6-znakowy kod autoryzacyjny ekranu. Skąd go wziąć? Wejdź do panelu webowego, do zakładki Ekrany, kliknij „Dodaj ekran", wpisz nazwę („Recepcja", „Sala 102", „Wejście") i wybierz typ (media lub qms_client). Po zapisaniu zobaczysz unikalny 6-znakowy kod, np. „A3B7K9". Wpisz ten kod w aplikacji desktop, w polu „Kod autoryzacyjny". Kod jest jednorazowy — po użyciu staje się nieaktywny i nie da się go ponownie wykorzystać.

KROK 3 KREATORA — WYBÓR MONITORA

Jeśli komputer ma kilka monitorów, kreator pokaże listę dostępnych ekranów z ich rozdzielczościami i opisami (Primary, Secondary itd.). Wybierz monitor, na którym ma działać aplikacja. Może to być monitor inny niż ten, na którym widzisz kreator — wybór dotyczy docelowego wyświetlania. Po wyborze monitora i kliknięciu „Zakończ" aplikacja przeparuje się z serwerem, pobierze konfigurację, a okno przeskoczy na wybrany monitor.

POMYŚLNE PAROWANIE

Po wpisaniu poprawnego kodu i kliknięciu „Zakończ" aplikacja łączy się z serwerem, weryfikuje kod i otrzymuje w odpowiedzi parametry ekranu: ID, nazwę, token API (przechowywany lokalnie w settings.json), typ ekranu, pierwszą playlistę. Cały proces trwa 2-5 sekund. Po sukcesie zobaczysz krótki komunikat „Wszystko gotowe! Wersja X.Y.Z, ekran #N — Recepcja, tryb: media" oraz tabelę skrótów klawiszowych. Aplikacja przechodzi do trybu wyświetlania.

CO SIĘ STAŁO W TLE

Aplikacja zapisała plik konfiguracyjny settings.json w folderze %APPDATA%\IneresSmsDesktop\. Plik zawiera: URL serwera, token API (unikalny dla tego ekranu, niewymienialny), ID ekranu, indeks monitora, ustawienia. Jeśli kiedykolwiek będziesz musiał przenieść konfigurację na inny komputer (np. po awarii), wystarczy skopiować ten plik — ekran nadal będzie ten sam.

JEŚLI KREATOR POJAWIA SIĘ PONOWNIE

Kreator wyświetla się tylko, gdy aplikacja nie ma jeszcze tokenu API lub został on unieważniony. Najczęstsze przyczyny ponownego pokazania się kreatora: ręczne wyczyszczenie settings.json, użycie skrótu Ctrl+Alt+W (wyloguj ekran), administrator unieważnił token z panelu (regen API token). Po update aplikacji kreator NIE pokazuje się — settings.json jest zachowany i token wciąż działa.

KOMUNIKAT „BŁĘDNY KOD" LUB „KOD WYGASŁ"

Kody autoryzacyjne są jednorazowe. Jeśli widzisz komunikat „Kod nieaktywny", oznacza to że ktoś już go wykorzystał lub kod został wygenerowany dawniej (kody ważne są 7 dni od utworzenia). Wróć do panelu, edytuj ekran, kliknij „Wygeneruj nowy kod autoryzacyjny" — otrzymasz nowy 6-znakowy kod. Stary kod zostaje unieważniony, więc upewnij się że nikt inny nie miał już aktywnej sesji parowania z poprzednim kodem.

TROUBLESHOOTING POŁĄCZENIA

Jeśli kreator nie może połączyć się z serwerem, sprawdź najpierw czy adres URL jest poprawny i czy komputer ma dostęp do internetu. Wpisz adres serwera w przeglądarce na tym samym komputerze — powinieneś zobaczyć stronę logowania. Jeśli strona się nie ładuje, problem leży poza Ineris SMS — sprawdź firewall, proxy, DNS. Jeśli strona się ładuje, ale aplikacja nie może się połączyć, sprawdź czy reguła zapory dla aplikacji Ineris SMS Desktop została dodana (instalator powinien to zrobić, ale możesz zweryfikować w Windows Defender Firewall → Reguły wychodzące).