Průvodce editorem Event Flow

0. Rychlá orientace

Co je tento editor?

Editor Event Flow představuje pokročilou automatizaci Social Stream Ninja. Doplňuje jednoduché přepínače nabídky a umožňuje sestavit vlastní logiku směrování. Použijte jej, když potřebujete:

• Předávejte chat mezi službami s filtry (např. zrcadlete Twitch do Discordu, ale blokujte příkazy).
• Vytvářejte věrnostní příkazy, hry s klíčovými slovy nebo podmínky účasti v losování pomocí logiky AND/OR/NOT.
• Spouštějte vlastní překryvy, zvuk, scény OBS nebo webhooky podle dat, která v toku obohatíte.
• Kombinujte více platforem v jedné automatizaci (Kick + Twitch + YouTube směrované jedním scénářem).

Nabídku chápejte jako rychlé předvolby a Event Flow jako sadu nástrojů pro vlastní postupy.

Každý scénář začíná spouštěčem

Uzly akcí (zelené) se nikdy nespouštějí samy — provedou se pouze tehdy, když se nadřazený spouštěč (modrý) vyhodnotí jako true. Scénář složený pouze z navazujících akcí vypadá platně, ale zůstává trvale nečinný, protože řetězec nemá co spustit. Názvy uzlů popisují, co uzel dělá, nikoli kdy se to děje: Vybrat zprávu k zobrazení (Feature Message) zvýrazní zprávu, když k ní tok dorazí – nespouští se při zvýraznění zprávy jinde.

Překryv Flow Actions (výstup akcí)

Uzly jako Přehrát zvukový klip (Play Audio Clip), Zobrazit mediální překryv (Display Media Overlay), a ovládání OBS potřebují plochu pro vykreslování. Tou je stránka překryvu Flow Actions dostupná na actions.html. Nechte ji běžet ve vysílacím softwaru (doky prohlížeče OBS/Streamer.bot atd.), aby se akce Event Flow měly kde zobrazit.

Po načtení může tento překryv:

• Zobrazovat GIPHY nebo přímé URL médií, text a konfety spouštěné vašimi scénáři.
• Přehrávat zvuky (TTS, zvukové klipy) místně, aby je diváci slyšeli.
• Komunikujte s OBS přes nastavení WebSocketu v sekci Flow Actions nabídky (přepínání scén, přepínání zdrojů, aktualizace textu GDI+/FreeType, záznam opakování atd.).

1. Co prochází uzlem?

Event Flow předává každým propojením dvě věci:

1. Datová zpráva – datový objekt události nebo zprávy.
2. Signál brány – jeden true/false příznak sdělující dalšímu uzlu, zda má běžet.

Očekávané vstupy

• Zdroje událostí (Twitch Message, Timers, Manual Trigger atd.) ignorují vstup z předchozích uzlů — vytvářejí vlastní datovou zprávu a vždy vydávají true pokud samotný uzel neskončí chybou.
• Transformační a logické uzly čtou data a mohou přepsat pole, nastavit stav nebo změnit signál brány na false.
• Uzly akcí se spouštějí pouze tehdy, když brána zůstává true. Mohou také vydat aktualizovanou datovou zprávu, pokud chcete pokračovat v řetězení akcí.

Způsoby výstupu

2. Přehled logických uzlů

Tyto bloky odpovídají na nejčastější otázky „Co znamená true/false?“.

3. Příklady malých scénářů

A. Automatická odpověď, pokud zpráva není příkaz

Zde uzel Regex vydává true když je zpráva příkazem. Vedeme false konektor do naší odpovědi, takže běžní účastníci chatu dostanou potvrzení, zatímco příkazy pouze projdou.

B. Vyžadování více kontrol pomocí AND

Uzel AND zajistí, že se na Discord přeposílají pouze členové používající správné klíčové slovo. Obě větve posílají svůj logický výsledek do uzlu AND; data z první větve pokračují dál.

C. Uzel NOT pro blokování opakovaných upozornění

State Check vrací hodnotu true když je upozornění ztlumené. Obrácením tohoto výsledku uzel NOT zajistí, že oslavu přehrajeme pouze tehdy, když je příznak false.

D. Náhodné přehrání jednoho ze dvou zvuků

Brána AND není volitelná. Samotný NOT by vydal true kdykoli je brána RANDOM nečinná, takže zvuk B by se přehrál u každé zprávy chatu, která neodpovídá vašemu spouštěči. Přivedení spouštěče do AND jako druhého vstupu omezí zvuk B pouze na odpovídající zprávy. Stejný vzor funguje pro jakoukoli dvojici alternativních akcí, nejen zvuk.

4. Prevence ozvěn, smyček a zpětného předávání

Předávání chatu mezi rozhraními je užitečné, ale pokud zachytáváte vlastní výstup, může vytvářet nekonečnou ozvěnu. Dodržujte tato opatření:

• Vyhněte se duplicitním systémům předávání. Při používání odpovídajících tras Event Flow vypněte globální Relay all a zkontrolujte další služby propojující stejné chaty. Zachování vlastních metadat při průchodu chatem platformy není zaručeno.
• Používejte uzly Debounce nebo Cooldown pro upozornění, která se mají spustit nejvýše jednou za X sekund.
• Cykly přerušujte záměrně. Pokud se dvě větve vzájemně napájejí, přidejte logický uzel kontrolující stavovou proměnnou („currentlyRelaying“), aby scénář při nastaveném příznaku skončil dříve.

5. Vstupy, výstupy a praktické otázky

Časté otázky a odpovědi

• Musím použít AND pro každou dvojici filtrů? Ne. Mnoho uzlů obsahuje více kontrol (například základní Message Filter podporuje klíčové slovo + roli). AND použijte pouze pro pokročilé kombinace nebo při slučování signálů z různých uzlů.
• Jak se hodnoty true/false dostanou do uzlu NOT? Každý uzel se zeleným výstupem vydává true ve výchozím stavu. Když podmínka selže, odešle false. Připojte tento spoj do NOT a obraťte výsledek.
• Může uzel vydat datovou zprávu, i když vrátí false? Ano. Data stále procházejí výstupem false; je na vás, kam tuto větev povedete.
• Jak rozpoznám členy týmu TikTok? Vyberte Člen týmu TikTok v uzlu Role uživatele. Rozpoznává úrovně a odznaky TikTok Fan Club/týmu v příchozí zprávě a nezávisí na nastavení hlavního překryvu chatu.
• Může každý uzel Speak Text používat jiný hlas? Ano. Zadejte název nebo ID hlasu podporované poskytovatelem do Přepsání hlasu, nebo pole nechte prázdné a použijte výchozí hlas TTS z Flow Actions.

6. Přehled proměnných šablon

Některé uzly akcí (Show Text, Set Text Source, Send Message, Relay Chat, TTS Speak, Call Webhook, Print Thermal Label) podporují proměnné šablon které se za běhu nahrazují daty události. Názvy proměnných uzavřete do složených závorek, například {username}.

Základní proměnné (zpětně kompatibilní)

Rozšířené proměnné

Ukázkové šablony

• Zobrazit text: {username} just cheered {hasDonation}!
• Nastavit textový zdroj OBS: {username}: now {counterValue}, need {counterTarget}
• Relay Chat: [{source}] {username}: {message}
• TTS: {username} says {message}
• Upozornění na dar: {username} donated {donation} - {subtitle}
• Termoštítek: {username}, nový řádek a pak {donation}. Viz Návod k termotiskárně pro nastavení tiskárny, štítky s pevnými rozměry a úplný tok.
• Call Webhook pro Discord: {"content":"{message}","username":"{username}","avatar_url":"{chatimg}"}

7. Kontrolní seznam doporučených postupů

• Pojmenujte a obarvěte své uzly, abyste později věděli, která větev je která.
• Testování vestavěným simulátorem (Send Test Event), než scénář nasadíte do živého provozu.
• Seskupujte logiku poblíž zdroje. Filtrujte co nejdříve, abyste se vyhnuli zbytečnému zpracování v dalších krocích.
• Opakování ukládejte do stavových uzlů. Pomocí počítadel, přepínačů a časových razítek předcházejte dvojím upozorněním.
• Dokumentujte pole meta. Když přidáváte vlastní meta klíče, zaznamenejte je, aby překryvy a vzdálení klienti zůstali sjednocení.

8. Další možnosti

Spouštění vlastních pracovních postupů ze Stream Decku nebo API: pojmenované spouštěče, úvodní šablona, vyhledávání pracovních postupů, doplňková data, příklady HTTP/WebSocket/P2P a gesta otočných ovladačů.

Chcete jít více do hloubky?

• Použijte Stavové uzly (počítadla, přepínače, časovače) ke sledování kontextu mezi událostmi.
• Kombinujte Proměnné a logika pro tvorbu systémů front, losování nebo bodování.
• Napojte se na systém Body a odměny , aby diváci mohli záměrně spouštět toky.
• Používáte desktopovou aplikaci SSApp? Odemknout Vlastní uzly JavaScriptu pro libovolnou logiku, kterou žádný vestavěný uzel nepokrývá.
• Zkontrolujte Referenční příručka událostí pro podrobnou dokumentaci dat zpráv napříč všemi platformami.

Tento návod je záměrně samostatný – zkopírujte jej místně, přizpůsobte týmu a dál experimentujte v editoru.

9. Vlastní JavaScript Pouze SSApp / desktopová aplikace

Dva uzly editoru Event Flow umožňují psát libovolný JavaScript, který se spouští v toku zpracování: Vlastní kód (Custom Code) (spouštěč) a Spustit vlastní kód (Execute Custom Code) (akce). Umožňují vyřešit vše, co vestavěné uzly nedokážou vyjádřit.

Vlastní kód — uzel spouštěče

Přetáhněte Vlastní kód (Custom Code) ze skupiny Pokročilé v panelu Spouštěče na plátno. Funguje jako brána: tok pokračuje pouze tehdy, když kód vrátí true.

Spustit vlastní kód — uzel akce

Přetáhněte Spustit vlastní kód (Execute Custom Code) ze skupiny Integrace (Integrations) v panelu Akce . Může upravit zprávu, zablokovat ji nebo připojit metadata, která mohou číst další uzly.

Objekt message

Oba uzly přijímají úplnou datovou zprávu události jako message. Níže uvedená pole jsou dostupná vždy; události konkrétních platforem mohou obsahovat další.

Co akce vrací

Z kódu akce vraťte prostý objekt. Všechna zahrnutá pole se sloučí do objektu result scénáře; pole, která vynecháte, si ponechají aktuální hodnoty.

Příklady úryvků kódu

Libovolnou z těchto ukázek zkopírujte do textového pole JavaScript Code u odpovídajícího typu uzlu.

Úryvky spouštěčů — vraťte true pro pokračování toku

Ukázky akcí — vracejí { modified, message }

Úplný příklad — bot pro návrhy nových funkcí od VIP

Tento tok naslouchá příkazu !feature <text> od předplatitelů, VIP nebo moderátorů, přeformátuje jej na návrh nové funkce a přepošle do druhého cíle (např. Discordu).

Krok 1 — spouštěč Vlastní kód (vložte do pole JavaScript Code spouštěče):

Krok 2 — akce Spustit vlastní kód (vložte do pole JavaScript Code akce):

Krok 3 — akce Přeposlat chat: za akci přidejte standardní uzel Relay Chat a nastavte ho na cíl Discord (nebo jiný). Zde není potřeba vlastní kód — přeformátované message.chatmessage prochází automaticky.

Bezpečnostní aspekty

• Bez síťového sandboxu. Kód akce může volat fetch(). Pokud přijímáte sdílené scénáře od jiných lidí, před aktivací zkontrolujte jejich JS.
• Chyby se zachytávají. Chyba při běhu vašeho kódu vrátí false (spouštěč), nebo neprovede nic (akce) a zapíše chybu do konzole DevTools — scénář nespadne.
• Také syntaktické chyby. Chyba typu SyntaxError při kompilaci se zachytí stejným způsobem. Pokud uzel zdánlivě nic nedělá, zkontrolujte vývojářské nástroje (F12).