Rozwiązywanie problemów z urządzeniami i łącznością

Diagnozuj najczęstsze problemy z urządzeniami, protokołami i łącznością w Arthoff oraz sprawdzaj konfigurację krok po kroku.

Ten przewodnik pomoże Ci zdiagnozować i naprawić najczęstsze problemy związane z urządzeniami (oświetlenie, dźwięk, kamery, maszyny efekte) w Arthoff. Podajemy kroki diagnostyczne, komunikaty o błędach i sposoby rozwiązywania konfliktów.

Urządzenie nie łączy się (status 🔴 Błędne połączenie)

Przyczyny i rozwiązania

Symptom	Możliwa przyczyna	Rozwiązanie krok po kroku
🔴 Błędne połączenie na liście urządzeń	Urządzenie wyłączone lub niedostępne w sieci.	1. Sprawdź, czy urządzenie jest włączone i posiada zasilanie. 2. Upewnij się, że urządzenie jest podłączone do tej samej sieci co komputer z Arthoff (ten sam podsieć IPv4). 3. Wykonaj polecenie `ping <adres_IP_urządzenia>` w wierszu poleceń (cmd/PowerShell) – jeśli odpowiedź “Request timed out”, sprawdź zaporę sieciową. 4. Jeśli urządzenie korzysta z Art‑Net/ sACN, upewnij się, że interfejs sieciowy obsługuje multicast (port 6454 UDP).
🟡 Trwa łączenie	Urządzenie nasłuchuje, ale jeszcze nie odpowiedziało.	1. Sprawdź protokół i port w Arthoff (np. Art‑Net → port 6454 UDP, MIDI → port 5005 UDP, OSC → port 8000 UDP). 2. Na samej konsoli urządzenia włącz tryb nasłuchiwania (Remote, API, OSC In). 3. Czekaj 10‑15 sekund – Arthoff automatycznie wykryje i zmieni status na 🟢 Połączone.
🟢 Połączone, ale wartości DMX nie są wysyłane	Błędne mapowanie kanałów lub filtr sieciowy.	1. W edytorze cue upewnij się, że wybrane urządzenie ma poprawny adres IP i universum. 2. Sprawdź w konsoli oświetleniowej, czy odbiera ona pakiety Art‑Net na odpowiednim universum. 3. Jeśli używasz VPN, upewnij się, że porty UDP nie są blokowane (często wymagane "split tunneling").

Panel diagnostyczny

W zakładce Urządzenia kliknij nazwę urządzenia → Panel testu (ikona 🔧).

Spróbuj ręcznie wprowadzić wartości (np. dla oświetlenia suwaki DMX 0‑255).

Jeśli suwaki działają, ale podczas odtwarzania cue nie działają – problem leży w wyzwalaczu (patrz sekcja „Wyzwalacze” niżej).

Jeśli suwaki są nieaktywne – problem leży w konfiguracji połączenia.

Cue nie uruchamia urządzenia (status działa, ale nie reaguje)

Przyczyny i rozwiązania

Symptom	Możliwa przyczyna	Rozwiązanie
Cue typu Lighting uruchomione, ale oświetlenie nie zmienia się	Cue ma wyzwalacz „Ręczny” i nie naciśnięto spacji, albo wyzwalacz „Automatycznie po poprzednim cue” nie działa poprawnie.	1. W trybie presentera naciśnij Spację lub przycisk ▶️. 2. Sprawdź zakładkę Wyzwalacz w edytorze tego cue – upewnij się, że typ odpowiada Twojemu zamierzeniu (Ręczny, Automatycznie po poprzednim cue, po czasie, itp.). 3. Jeśli używasz wyzwalacza MIDI/OSC, upewnij się, że odpowiedni sygnał został faktycznie przesłany (sprawdź konsolę MIDI/OSC monitor).
Cue typu Audio nie odtwarza dźwięku	Źródło dźwięku nie wybrane, głośność ustawiona na 0, lub urządzenie nie działa.	1. W edytorze cue audio upewnij się, że w polu Urządzenie wybrano poprawne urządzenie (mikser, odtwarzacz). 2. Sprawdź głośność w formularzu (czy nie jest na 0%). 3. Upewnij się, że plik źródłowy (MP3/WAV) istnieje i jest dostępny (załącznik w projekcie lub URL). 4. W trybie presentera sprawdź Panel testu urządzenia dźwiękowego (ikona głośnika).
Cue typu Camera nie zmienia perspektywy	Kamera nie obsługuje sterowania przez protokół, albo wyzwalacz OSC/MIDI źle skonfigurowany.	1. Sprawdź specyfikację kamery – niektóre modele wymagają dedykowanego oprogramowania do sterowania PTZ (VISCA, NDI Tools). 2. W edytorze cue camera otwórz zakładkę Wyzwalacz i upewnij się, że wybrany protokół (OSC, MIDI) zgadza się z konfiguracją urządzenia (adres IP, port, numer kanału). 3. Użyj Panel testu kamerą (ikona kamery) i spróbuj ręcznie wprowadzić wartości Pan/Tilt/Zoom – jeśli działają, problem leży w wyzwalaczu.

Konflikty synchronizacji (zmiany wprowadzone przez wielu użytkowników)

Objawy

Na dwóch urządzeniach ten sam cue jest oznaczony jako „wykonane” przez różnych osób, a system zgłasza konflikt przy synchronizacji.
W trybie offline oznaczasz cue, a po reconnect pojawia się komunikat o rozbieżności.

Rozwiązanie

Rozpoznanie konfliktu

Arthoff wyświetli okno z opcjami: Zastosuj wersję serwera, Zastosuj wersję lokalną, Otwórz w edytorze.

Decyzja

Wybierz Zastosuj wersję serwera, jeśli chcesz zachować stan, jaki mają inni współtwórcy (np. podczas prób zespół pracuje równolegle).
Wybierz Zastosuj wersję lokalną, jeśli Twoje zmiany są ostateczne i chcesz je nadpisać na serwerze.
Wybierz Otwórz w edytorze, aby ręcznie wybrać, które elementy zachować (np. oznaczenia akora pozostawić, a zmiany w cue oświetlenia cofnąć).

Unikanie konfliktów w przyszłości

Jeśli pracujecie równolegle nad tym samym skryptem, zalecamy korzystanie z funkcji „Lock” (zablokowanie sekcji) – tylko jedna osoba w danej chwili ma prawo edytować dany skrypt/sekcja.
Komunikuj się przez wbudowany czat w Arthoff – gdy ktoś zaczyna wprowadzać zmiany, pisze w czacie „Teraz edytuję sekcję 3 – czekajcie”.
Wykorzystaj historię wersji (ikona zegara ⏳) – co jakiś czas robienie checkpointów pozwala cofnąć się do poprzedniego stanu bez konfliktów.

Wiadomości o błędach w konsoli dewelerskiej (F12 → Console)

Arthoff wykorzystuje bibliotekę Dexie do lokalnego przechowywania danych. Jeśli napotkasz komunikaty typu DOMException: Failed to read the 'value' property from IndexedDB lub QuotaExceededError, oznacza to:

Problemy z pamięcią podręczną (IndexedDB)

Wyczyść pamięć podręczną przeglądarki (w ustawieniach → prywatność i dane stron → wyczyść dane witryn).
Zrestartuj Arthoff (odśwież stronę z Ctrl+F5).

Przekroczenie limitu miejsca

Choć Arthoff wykorzystuje możliwości browserowe, bardzo duże projekty (setki cue z plikami audio) mogą przekroczyć limit LocalStorage/IndexedDB. Rozwiązaniem jest podział projektu na mniejsze skrypty lub eksportowanie starszych wersji jako pliki JSON i ich archiwizowanie na zewnętrznym dysku.

Pomoc techniczna

Jeśli powyższe kroki nie rozwiązują problemu:

Otwórz konsolę dewelerską (F12 → zakładka Console) i zapisz ostatnie błędy (kopiuj tekst).

Skontaktuj się z pomocą techniczną, dostarczając:

Numer wersji Arthoff (widoczny w stopce strony).
Model urządzenia i jego firmware.
Architekturę sieci (czy korzystasz z VPN, dedykowanej podsieci).
Opis dokładnych kroków, które doprowadziły do błędu.
Zrzuty ekranu komunikatów o błędach oraz stan urządzenia na wykresie wartości DMX/MIDI/OSC.

Pamiętaj, że większość problemów wynika z nieprawidłowego adresu IP, błędnego protokołu lub niewłaściwego wyzwalacza – sprawdzenie tych trzech elementów rozwiązuje większość przypadków.

Szybki checklist przed każdą próbą lub wydarzeniem:

Wszystkie urządzenia włączone i podłączone do tej samej sieci.

Status każdego urządzenia w Arthoff to 🟢 Połączone.

Wyzwalacze w cue są ustawione zgodnie z planem (ręczne vs automatyczne).

Przeprowadzono krótki test w panelu testu urządzeń.

Zapisano stan projektu lub zrobiono checkpoint (ikona zegara) przed rozpoczęciem.

Na tej stronie