Event-Flow-Editor-Leitfaden

0. Kurze Orientierung

Was ist dieser Editor?

Der Event-Flow-Editor bildet die Ebene für erweiterte Automatisierung in Social Stream Ninja. Er ergänzt die einfachen Popup-Schalter und erlaubt eigene Weiterleitungslogik. Verwende ihn, wenn du:

• Leite Chat mit Filtern zwischen Diensten weiter (z. B. Twitch nach Discord spiegeln, aber Befehle blockieren).
• Erstelle treuebasierte Befehle, Schlüsselwortspiele oder Teilnahmebedingungen für Verlosungen mit AND/OR/NOT-Logik.
• Löse eigene Overlays, Audio, OBS-Szenen oder Webhooks anhand von Daten aus, die du im Flow ergänzt.
• Kombiniere mehrere Plattformen in einer Automatisierung (Kick + Twitch + YouTube durch einen Flow).

Das Popup bietet schnelle Voreinstellungen; Event Flow ist der Werkzeugkasten für eigene Abläufe.

Jeder Flow beginnt mit einem Auslöser

Aktionsknoten (grün) laufen nie von selbst. Ein darüberliegender Auslöserknoten (blau) muss folgendes Ergebnis liefern: true. Ein Flow nur aus verketteten Aktionen sieht gültig aus, bleibt aber dauerhaft inaktiv, weil nichts die Kette startet. Knotennamen beschreiben, was der Knoten macht, nicht wann es geschieht: Nachricht hervorheben hebt eine Nachricht hervor, wenn der Flow ihn erreicht — er wird nicht ausgelöst, wenn du anderswo eine Nachricht hervorhebst.

Flow-Actions-Overlay (Aktionsausgabe)

Knoten wie Audioclip abspielen, Medien-Overlay anzeigen, und die OBS-Steuerungen benötigen eine Darstellungsfläche. Diese Fläche ist die Flow-Actions-Overlay-Seite unter actions.html. Lasse sie in deiner Streaming-Software (OBS-/Streamer.bot-Browser-Docks usw.) laufen, damit Event-Flow-Aktionen einen Ort zur Darstellung haben.

Nach dem Laden kann dieses Overlay:

• GIPHY oder direkte Medien-URLs, Text und Konfetti anzeigen, ausgelöst durch deine Flows.
• Sounds (TTS, Audioclips) lokal abspielen, damit Zuschauer sie hören.
• Sprich mit OBS über die WebSocket-Einstellungen unter Flow Actions im Popup (Szenenwechsel, Quellen umschalten, GDI+/FreeType-Textupdates, Wiederholungspuffer usw.).

1. Was läuft durch einen Knoten?

Die Event-Flow-Laufzeit reicht zwei Dinge durch jede Verbindung:

1. Nutzdaten – das Ereignis- oder Nachrichtendatenobjekt.
2. Gate-Signal – ein true/false Bit, das dem nächsten Knoten sagt, ob er laufen soll.

Erwartete Eingaben

• Ereignisquellen (Twitch Message, Timer, Manual Trigger usw.) ignorieren vorgelagerte Eingaben — sie erzeugen eigene Nutzdaten und geben immer true sofern der Knoten selbst keinen Fehler hat.
• Transformations- und Logikknoten lesen die Nutzdaten, ändern gegebenenfalls Felder oder Zustände und setzen das Gate-Signal gegebenenfalls auf false.
• Aktionsknoten werden nur bei folgendem Gate-Signal ausgelöst: true. Sie können weiterhin aktualisierte Nutzdaten ausgeben, wenn du weitere Aktionen verketten möchtest.

Ausgabemuster

2. Kurzreferenz der Logikknoten

Diese Blöcke beantworten die häufigsten Fragen zur Bedeutung von true/false.

3. Beispiele kleiner Flows

A. Automatisch antworten, sofern die Nachricht kein Befehl ist

Hier lautet die Regex-Ausgabe true bei einer Nachricht, die ein Befehl ist. Wir leiten den Anschluss false zu unserer Antwort, damit normale Chatter eine Bestätigung erhalten, während Befehle einfach durchlaufen.

B. Mehrere Prüfungen mit AND verlangen

Der AND-Knoten stellt sicher, dass nur Mitglieder mit dem richtigen Schlüsselwort nach Discord weitergeleitet werden. Beide Zweige senden ihr boolesches Ergebnis an AND; die Nutzdaten vom ersten Zweig werden weitergereicht.

C. NOT-Knoten zum Blockieren wiederholter Benachrichtigungen

State Check liefert den Wert true wenn die Benachrichtigung stummgeschaltet ist. Durch Umkehren dieses Ergebnisses sorgt NOT dafür, dass die Feier nur bei folgendem Flag-Wert abgespielt wird: false.

D. Zufällig einen von zwei Sounds abspielen

Das AND-Gatter ist nicht optional. Ein alleinstehendes NOT würde true ausgeben, wenn RANDOM inaktiv ist; Sound B würde daher bei jeder Chatnachricht spielen, die nicht zu deinem Auslöser passt. Wenn der Auslöser als zweiter Eingang in AND geht, wird Sound B auf passende Nachrichten begrenzt. Dasselbe Muster funktioniert für jedes Entweder-oder-Paar von Aktionen, nicht nur Audio.

4. Echos, Schleifen und Relay-Rückkopplungen verhindern

Chat zwischen Oberflächen weiterzuleiten ist leistungsfähig, kann aber endlose Echos erzeugen, wenn du die eigene Ausgabe erfasst. Beachte diese Schutzmaßnahmen:

• Doppelte Relay-Systeme vermeiden. Deaktiviere globales „Relay all“, wenn du gleichwertige Event-Flow-Wege verwendest, und prüfe andere Dienste, die dieselben Chats verbinden. Eigene Metadaten bleiben auf dem Weg durch einen Plattformchat nicht garantiert erhalten.
• Debounce- oder Cooldown-Knoten verwenden für Benachrichtigungen, die nur alle X Sekunden ausgelöst werden sollen.
• Schleifen bewusst unterbrechen. Wenn zwei Zweige einander speisen, füge einen Logikknoten hinzu, der eine Zustandsvariable („currentlyRelaying“) prüft, damit der Flow bei gesetztem Flag früh endet.

5. Eingänge, Ausgänge und praktische Fragen

Häufige Fragen und Antworten

• Muss ich für jedes Filterpaar AND verwenden? Nein. Viele Knoten enthalten mehrere Prüfungen (der einfache Message Filter unterstützt etwa Schlüsselwort + Rolle). Verwende AND nur für fortgeschrittene Kombinationen oder beim Zusammenführen von Signalen verschiedener Knoten.
• Wie gelangen true/false-Werte zum NOT-Knoten? Jeder Knoten mit grünem Ausgang liefert true standardmäßig. Wenn eine Bedingung fehlschlägt, liefert er false. Verbinde diese Leitung mit NOT, um das Ergebnis umzukehren.
• Kann ein Knoten Nutzdaten ausgeben, selbst wenn er false zurückgibt? Ja. Die Nutzdaten laufen weiter durch den false-Ausgang; du entscheidest, wohin dieser Zweig führen soll.
• Wie erkenne ich TikTok-Team-Mitglieder? Wähle TikTok-Team-Mitglied im User-Role-Knoten. Er erkennt TikTok-Fanclub-/Team-Level und Abzeichen an der eingehenden Nachricht und hängt nicht von den Main-Chat-Overlay-Einstellungen ab.
• Kann jeder Speak-Text-Knoten eine andere Stimme verwenden? Ja. Gib einen vom Anbieter unterstützten Stimmennamen oder eine ID in Stimme überschreiben ein, oder lasse es leer, um die TTS-Standardstimme von Flow Actions zu verwenden.

6. Referenz der Vorlagenvariablen

Mehrere Aktionsknoten (Show Text, Set Text Source, Send Message, Relay Chat, TTS Speak, Call Webhook, Print Thermal Label) unterstützen Vorlagenvariablen , die zur Laufzeit durch Ereignisdaten ersetzt werden. Setze Variablennamen in geschweifte Klammern wie {username}.

Kernvariablen (abwärtskompatibel)

Erweiterte Variablen

Beispielvorlagen

• Text anzeigen: {username} just cheered {hasDonation}!
• OBS-Textquelle setzen: {username}: now {counterValue}, need {counterTarget}
• Relay Chat: [{source}] {username}: {message}
• TTS: {username} says {message}
• Spendenbenachrichtigung: {username} donated {donation} - {subtitle}
• Thermoetikett: {username}, eine neue Zeile, dann {donation}. Siehe die Thermodrucker-Anleitung für Druckereinrichtung, Etiketten fester Größe und einen vollständigen Flow.
• Discord Call Webhook: {"content":"{message}","username":"{username}","avatar_url":"{chatimg}"}

7. Checkliste bewährter Vorgehensweisen

• Benenne und färbe deine Knoten, damit du später noch weißt, welcher Zweig welcher ist.
• Mit dem integrierten Simulator testen (Send Test Event), bevor du einen Flow live schaltest.
• Logik nahe der Quelle gruppieren. Filtere möglichst früh, um nachgelagerte Verarbeitung zu vermeiden.
• Wiederholungen in Zustandsknoten speichern. Verwende Zähler, Schalter und Zeitstempel, um doppelte Benachrichtigungen zu vermeiden.
• Meta-Felder dokumentieren. Wenn du eigene meta Schlüssel hinzufügst, dokumentiere sie, damit Overlays und entfernte Clients konsistent bleiben.

8. Weiterführende Möglichkeiten

Eigene Abläufe über Stream Deck oder API ausführen: benannte Auslöser, eine Startvorlage, Auffinden von Abläufen, Zusatzdaten, HTTP-/WebSocket-/P2P-Beispiele und Drehregler-Gesten.

Bereit für mehr Details?

• Verwende Zustandsknoten (Zähler, Schalter, Timer), um Kontext zwischen Ereignissen zu verfolgen.
• Kombiniere Variablen und Logik zum Erstellen von Warteschlangen, Verlosungen oder Wertungssystemen.
• Verbinde dich mit dem System Punkte und Belohnungen , damit Zuschauer Flows bewusst auslösen können.
• Nutzt du die SSApp-Desktop-App? Freischalten Eigene JavaScript-Knoten für beliebige Logik, die kein integrierter Knoten abdeckt.
• Prüfe die Ereignisreferenz für ausführliche Nutzdatendokumentation aller Plattformen.

Diese Anleitung ist bewusst eigenständig — kopiere sie lokal, passe sie für dein Team an und experimentiere weiter im Editor.

9. Eigenes JavaScript Nur SSApp / Desktop

Zwei Knoten im Event-Flow-Editor erlauben beliebiges JavaScript innerhalb der Flow-Verarbeitung: Eigener Code (Auslöser) und Eigenen Code ausführen (Aktion). Sie sind der Ausweg für alles, was die integrierten Knoten nicht ausdrücken können.

Custom Code — Auslöserknoten

Ziehe Eigener Code aus der Gruppe Erweitert im Bereich Auslöser auf die Arbeitsfläche. Er dient als Gate: Der Flow läuft nur bei folgendem Rückgabewert deines Codes weiter: true.

Execute Custom Code — Aktionsknoten

Ziehe Eigenen Code ausführen aus der Gruppe Integrationen im Bereich Aktionen . Er kann die Nachricht verändern, blockieren oder Metadaten für nachgelagerte Knoten anhängen.

Das Objekt message

Beide Knoten erhalten die vollständigen Ereignisnutzdaten als message. Die folgenden Felder sind immer verfügbar; plattformspezifische Ereignisse können zusätzliche enthalten.

Was die Aktion zurückgibt

Gib aus deinem Aktionscode ein einfaches Objekt zurück. Alle enthaltenen Felder werden in das result Objekt übernommen; ausgelassene Felder behalten ihre aktuellen Werte.

Codebeispiele

Kopiere eines dieser Beispiele in das JavaScript-Code-Textfeld des passenden Knotentyps.

Auslöserbeispiele — liefere als Rückgabewert true um den Flow fortzusetzen

Aktionsbeispiele — liefere als Rückgabewert { modified, message }

Vollständiges Beispiel — Bot für VIP-Funktionswünsche

Dieser Flow wartet auf !feature <text> von Abonnenten, VIPs oder Moderatoren, formatiert sie als Funktionswunsch und leitet sie an ein zweites Ziel (z. B. Discord) weiter.

Schritt 1 — Custom-Code-Auslöser (in das Feld JavaScript Code des Auslösers einfügen):

Schritt 2 — Execute-Custom-Code-Aktion (in das Feld JavaScript Code der Aktion einfügen):

Schritt 3 — Relay-Chat-Aktion: Füge nach der Aktion einen normalen Relay-Chat-Knoten hinzu und konfiguriere ihn für dein Discord-Ziel (oder ein anderes). Hier ist kein eigener Code erforderlich — der umformatierte Wert von message.chatmessage läuft automatisch durch.

Sicherheitsaspekte

• Keine Netzwerk-Sandbox. Aktionscode unterstützt Aufrufe von fetch(). Wenn du geteilte Flows von anderen übernimmst, prüfe vor der Aktivierung das JavaScript.
• Fehler werden abgefangen. Ein Laufzeitfehler in deinem Code gibt false (Auslöser) oder eine wirkungslose Aktion zurück und protokolliert in der DevTools-Konsole — der Flow stürzt nicht ab.
• Auch Syntaxfehler. Ein Fehler vom Typ SyntaxError beim Kompilieren wird genauso abgefangen. Prüfe DevTools (F12), wenn ein Knoten scheinbar nichts tut.