SERVIS — oživení instalace

CueX Manager · bundle manager_servis · aktualizováno 2026-07-26

Co je SERVIS mód

SERVIS mód proměňuje mapu instalace v CueX Manageru v ovládací panel pro techniky na place — první zapojení nebo diagnostiku bez otevírání CueX Editu. Přepínač SERVIS je v hlavičce vedle UPRAVIT; aktivní SERVIS je vidět na první pohled — šrafovaný okraj mapy.

Proč to existuje. Při zapojování instalace (Den zapojení) potřebuje technik rychle ověřit „svítí tohle světlo?", „jede tahle obrazovka?" bez nutnosti spouštět celý CueX Edit a procházet projekt — jeden klik na mapě stačí.

Postup na place — mapa → klik → co se stane

Klik na koncové zařízení s telemetrií (světlo, výstup) → LOCATE — fixture na plný výkon (bílá/otevřeno), 60 s auto-off. Klik na jiné zařízení přepne locate na něj — vždy jen jedno aktivní najednou.
Klik na projektor → okamžité zapnutí přes PJLink + zobrazení stavu (zapíná se / zapnuto / chyba spojení).
Klik na PlayX box → TEST KARTA — barevná zkušební obrazovka s popiskem. Manager label doplní automaticky: přátelské jméno + zóna (např. „PLAYER · Sál"), technik nemusí nic psát. Alt+klik přidá zkušební tón (440 Hz).
Odznak s odpočtem nad zařízením ukazuje zbývající čas do auto-off (nebo „AKTIVNÍ" u blackoutu, který auto-off nemá — bezpečný stav).

[SCREENSHOT: mapa v SERVIS módu, šrafovaný okraj + odznak s odpočtem — čeká na E2E gate s prohlížečem]

Hromadné povely

Panel zóny v SERVIS módu (nebo REST na celou zónu/instalaci) přidá tři tlačítka na celou zónu/instalaci najednou:

VŠE ROZSVÍTIT — nastavitelná intenzita, cílí na runtime boxy v rozsahu.
BLACKOUT — všechny DMX kanály na 0, bez auto-off.
VŠECHNY OBRAZOVKY — test karta na všechny PlayX boxy v rozsahu najednou, každý dostane svůj vlastní počítaný popisek.

Zásah se posílá na každé zařízení zvlášť; offline zařízení se v odpovědi vrátí zvlášť (offline) a nezastaví zbytek dávky.

Guard — servisní povel během živé show

Pokud na zařízení právě běží playlist v SHOW módu (nebo PlayX zrovna přehrává), servisní povel vrátí 409 show_running — dashboard i lokální web UI Runtime/PlayX na to zareagují potvrzovacím dialogem a při souhlasu povel zopakují s force:true, který guard obejde.

Bez potvrzení se show nikdy tiše nepřepíše servisním povelem. Guard je stejný na všech třech úrovních — přímo na krabičce (Runtime/ PlayX Ops API), přes Manager (jedno zařízení) i přes hromadné povely.

REST příklady

# Jedno zařízení (Manager REST, whitelist + validace parametrů)
curl -X POST http://manager:4080/api/devices/<deviceId>/action \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"action":"service_locate","params":{"deviceId":"<fixtureId>"}}'

# Celá zóna — rozsvítit na 100 %
curl -X POST http://manager:4080/api/zones/<zoneId>/service/all-on \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"intensity":1}'

# Přímo na krabičce, bez Manageru (technik na místě)
curl -X POST http://cuex-box:9080/api/service/blackout \
  -H 'Content-Type: application/json' -d '{"force":true}'

Plný přehled Ops API povelů (Runtime i PlayX) a MCP nástrojů: příručka §25.5 (Runtime), §26.14 (PlayX) a §32.9b (Manager, tato stránka v kontextu celé kapitoly 32).

→ Kompletní příručka (kapitola 32 — CueX Manager)