| Name | Gruppe | Universe | Adresse | Kanäle |
|---|
Das Plugin fragt diese Adresse regelmässig ab und holt sich den aktuellen Zustand. Es braucht keinen offenen Port am Server – nur ausgehendes HTTPS.
…X-DMX-Token)••••••••••••••••GET app.php?api=dmx-plugin&since=<letzte rev>&wait=5&v=<plugin-version>
Header: X-DMX-Token: <token>
→ nichts neu: {"changed": false, "rev": 42}
→ Änderung: {
"changed": true,
"rev": 43, // bei jeder Änderung hochgezählt
"seq": 17, // zählt jede Eingabe/Szene (auch ohne Wertänderung)
"fadeMs": 1000, // so lange soll zum Zielwert übergeblendet werden
"blackout": false,
"master": 100,
"fixtures": [{
"id": "a1b2c3", "name": "Moving Head 1", "group": "Bühne",
"universe": 1, "address": 1,
"channels": ["pan","tilt","dimmer","r","g","b"],
"values": {"pan":128,"tilt":90,"dimmer":255,"r":0,"g":120,"b":255},
"dmx": [128,90,255,0,120,255], // fertig, Master & Blackout eingerechnet
"position": {"x":10,"y":64,"z":-3} // oder null
}]
}
Mit wait=5 hält der Server die Anfrage bis zu 5 Sekunden offen und antwortet sofort bei einer Änderung (Long-Polling, max. 8 s). Ohne wait antwortet er direkt. Empfohlen: wait=5, danach sofort neu anfragen – das ergibt eine Reaktionszeit von unter einer Sekunde.
POST app.php?api=dmx-plugin
Header: X-DMX-Token: <token>
Body: {"version":"1.0.3","online":4,"info":"4 Fixtures geladen"}
alle Werte 0–255 pan 0–255 → 0–540° tilt 0–255 → 0–270° (Mitte = 128) dimmer 0 = aus strobe 0 = aus, höher = schneller Master & Blackout wirken bereits auf "dmx"/"values.dimmer" fadeMs: lineare Überblendung vom aktuellen zum Zielwert
pan, tilt, dimmer, r, g, b, strobe, zoom, focus, gobo, prism → nur die beim Fixture aktivierten Kanäle zählen; "dmx" ist bereits in dieser Reihenfolge