State
Persistente Werte über Streams hinweg
Events sind flüchtig, State bleibt. Ein State ist ein Key-Value-Paar, das pixl serverseitig speichert: Counter-Stände, Ziele, Toggles. Der Wert überlebt Reloads, OBS-Neustarts und Stream-Enden.
State abonnieren
overlay.state('counter.deaths', (value) => {
document.querySelector('#count').textContent = value;
});Der Callback läuft einmal beim Verbinden mit dem aktuellen Wert und danach bei jeder Änderung, egal ob sie aus dem Dashboard, von der Controls-Seite oder von einem Twitch-Event kommt.
Woher kommen die Werte?
State wird über die Controls-Seite im Dashboard geändert. Wer dein Widget freigegeben bekommt, kann Counter erhöhen, Werte setzen oder Toggles umschalten, und dein Widget bekommt die Änderung live.
Keys sind frei wählbar, mit Punkten als Namensraum, z.B. counter.deaths oder goal.subs. Sie gelten pro Organisation, mehrere Widgets können denselben Key abonnieren.
In Arbeit
Schreibender State-Zugriff direkt aus dem SDK sowie eigene Controls-Definitionen für die Controls-Seite werden hier bald dokumentiert.
© 2026 pixl