Systém Event Flow
Čeština
EnglishEspañolPortuguês (Brasil)РусскийFrançaisDeutsch日本語简体中文繁體中文ItalianoPolski한국어УкраїнськаالعربيةTürkçeČeštinaไทย

Průvodce stavovými uzly

Stavové uzly dávají Social Stream Ninja paměť. Vytvářejte s nimi čekací doby, přepínače, počítadla, omezovače četnosti, seznamy účastníků a losování cen, díky nimž budou automatizace předvídatelné.

01 · Rychlá orientace

Stavové nástroje mají objekt, který vlastní hodnotu, a operace, které ji čtou nebo mění:

Stavový uzel

  • Nachází se na plátně.
  • Uchovává hodnotu (ON/OFF, počet, časové údaje nebo uživatele).
  • Gate, Counter a Rate Limiter mohou být součástí běžné cesty události.
  • Paměť uživatelů je sdílený uzel, na který odkazují ostatní uzly.

Stavová akce

  • Umísťují se dále po směru toku.
  • Čte nebo mění uloženou hodnotu (nastaví ON, přičte +1, zapamatuje, vylosuje, resetuje atd.).
  • Může být kdekoli ve scénáři — stačí vybrat název odpovídajícího uzlu.
Pamatujte: Nejprve přidejte stavový uzel, pojmenujte ho jedinečným názvem a pak ho vyberte v každé odpovídající operaci. Bez základního uzlu nemají stavové akce co aktualizovat.

02 · Přepínač zapnuto/vypnuto (brána)

Přepínač je logická brána. Ve stavu ON zprávy propouští; ve stavu OFF se scénář v tomto uzlu zastaví.

Nejlepší pro

  • Čekací doby chatových příkazů.
  • Ruční přepínače (zapnutí/vypnutí překryvů).
  • Servisní přestávky (pozastavení funkcí během scén BRB).

Hlavní akce

  • Set Gate State— přepněte na ON nebo OFF.
  • Reset State Node— obnovte výchozí stav (obvykle ON).

Příklad: čekací doba 15 s

!hello ──▶ Přepínač (ON?) ─▶ Odeslat odpověď ─▶ Nastavit bránu: OFF ─▶ Prodleva 15 s ─▶ Nastavit bránu: ON

Postup sestavení

  1. Vložte uzel přepínače, pojmenujte ho „helloCooldown“ a nastavte výchozí stav ON.
  2. Propojte spouštěč → přepínač → akce.
  3. Za svou akci přidejte Nastavit stav brány (Set Gate State) (OFF) odkazující na „helloCooldown“.
  4. Přidejte Prodleva (Delay) uzel (15 sekund).
  5. Přidejte další Nastavit stav brány (Set Gate State) (ON) pro „helloCooldown“.

03 · Počítadlo

Počítadla uchovávají číselné hodnoty napříč zprávami. Automaticky se zvyšují při průchodu zprávy a hodnoty můžete ručně upravovat pomocí akcí.

Automatické navyšování: Pokaždé, když datová zpráva projde uzlem Counter, přičte se 1 (pokud ho nepozastavíte volbou „Only count when gate is true“).

Příklady použití

  • Každý N-tý účastník chatu spustí cenu.
  • Sledujte pokrok ke společnému cíli komunity.
  • Uchovávejte body uplatněné pomocí příkazů.

Akce

  • Increment Counter— přičtěte nebo odečtěte vlastní hodnoty.
  • Set Counter Value— přejděte na konkrétní číslo.
  • Reset State Node— obnovte výchozí počáteční hodnotu.

Příklad: oslava každých 5 zpráv

Libovolná zpráva ─▶ Počítadlo (název: hype5) ─▶ Podmínka (value % 5 === 0?) ─▶ Spustit oslavu

V uzlu Condition porovnejte state.hype5.value nebo jednoduše použijte vestavěnou volbu „Trigger when value matches Target“ ve vlastnostech uzlu Counter.

04 · Omezovač četnosti

Omezovač si pamatuje časové údaje a odmítá nové události, dokud nebude dodržena zadaná četnost.

Vhodné, když potřebujete

  • „Pouze pět přihlášek do losování za minutu.“
  • „Jedno volání API za 10 sekund.“
  • „Zahodit upozornění, pokud je překryv už zaneprázdněný.“

Konfigurace

  • Nastavte maximální povolený počet událostí.
  • Zvolte časové okno (v sekundách).
  • Rozhodněte, zda nadlimitní události zařadit do fronty, nebo zahodit.
Pozor: Omezovače se při úpravě scénáře automaticky neresetují. Použijte Reset State Node pokud potřebujete při testování začít od nuly.

05 · Paměť uživatelů

Paměť uživatelů vlastní jeden pojmenovaný seznam jedinečných osob. Zapamatujte si uživatele při zapojení, zkontrolujte seznam u pozdějších zpráv, odeberte osobu, vyberte náhodného vítěze nebo vymažte pouze tento seznam.

Nejlepší pro

  • Způsobilost podle dárků nebo odznaků.
  • Zapamatování diváků, kteří dali lajk, přihlásili se nebo se zapojili.
  • Losování cen s jednou účastí na uživatele.
  • Samostatné seznamy pro různé kampaně.

Operace

  • Remember User a Forget User.
  • User Is Remembered.
  • Pick Random User.
  • Clear All Users nebo Reset State Node.
Spouštěč účasti ──▶ Zapamatovat uživatele ······▶ Paměť uživatelů: Účastníci Příkaz losování ──▶ Vybrat náhodného uživatele ·▶ Paměť uživatelů: Účastníci Příkaz resetu ────▶ Vymazat všechny uživatele ··▶ Paměť uživatelů: Účastníci

Plné tyrkysové spoje přenášejí události. Přerušované fialové spoje ukazují, kterou sdílenou paměť operace používá. Každá paměť uživatelů má vlastní počet, režim uchování a pravidla resetování, takže vymazání jednoho seznamu neovlivní jiný.

Viz samostatný Průvodce pamětí uživatelů — obsahuje ověřené snímky obrazovky, scénář losování ke stažení, způsobilost na TikToku, příklady účasti a podrobnosti resetování.

06 · Řešení typických úloh

Vyberte scénář použití a postupujte podle kroků.

Čekací doba příkazu

  1. Uzel přepínače s názvem „commandCooldown“.
  2. Spouštěč → přepínač → odpověď.
  3. Nastavit bránu na OFF → Prodleva → Nastavit bránu na ON.
  4. V případě potřeby přidejte na výstup false zprávu do chatu „Čekací doba je aktivní“.

Omezený počet odměn zdarma

  1. Počítadlo s výchozí hodnotou 0 a cílem 3.
  2. Po každém uplatnění odměny zvyšte hodnotu.
  3. Když value ≥ 3, přejděte do větve „Omlouváme se, vše je pryč“.
  4. Na konci vysílání použijte akci Reset.

Přepínač pro diváky

  1. Přepínač s názvem „overlayToggle“.
  2. !overlay on příkaz → Nastavit bránu na ON.
  3. !overlay off příkaz → Nastavit bránu na OFF.
  4. Všechny spouštěče překryvů procházejí přepínačem.

Příklady schémat scénářů

Spouštěč ─▶ Přepínač (overlayToggle) ─▶ Pokud ON → Zobrazit překryv └─false─▶ Upozornit moderátora „Překryv vypnut“
Uplatnit odměnu ─▶ Počítadlo ticketsSold ├─value < 50 ─▶ Schválit uplatnění └─value ≥ 50 ─▶ Zamítnout + vrátit body

07 · Řešení potíží a časté otázky

Projev Pravděpodobná příčina Řešení
Akci Set Gate State nelze uložit. Odpovídající uzel přepínače neexistuje (nebo se liší názvy). Nejprve přidejte uzel přepínače a ověřte, že na něj odkazuje rozbalovací nabídka.
Počítadlo se nikdy nezvyšuje. Scénář obchází uzel počítadla nebo má brána hodnotu false. Ověřte, že spoj ze spouštěče prochází počítadlem a výstup brány je true.
Omezovač blokuje všechno navždy. Příliš přísné časové okno nebo zbývající stav z testování. Před opakováním testu zmírněte limit a přidejte akci Reset State Node.
Operace paměti uživatelů nemá přerušovaný spoj. Není vybrána cílová paměť. Ve vlastnostech operace vyberte pojmenovanou paměť nebo na ni přetáhněte fialový boční konektor.
Tlačítka návodů nic neotevřou. Běží v rozšíření bez aktualizovaných prostředků web_accessible. Ověřte, že actions/state-nodes-guide.html je zahrnut přes manifest, a znovu načtěte rozšíření.

Kontrolní seznam testování

  • Příkazy simulujte nástrojem „Send Test Event“ v Event Flow.
  • Při ověřování dočasně zkraťte čekací doby (na 2 sekundy) nebo snižte cíle počítadel.
  • Mezi testy resetujte stavové uzly, abyste nečetli zastaralá data.
  • Označte větve (např. „false → čekací doba aktivní“), abyste mohli cestu sledovat vizuálně.

08 · Další kroky

Kombinujte stavové uzly s dalšími nástroji Event Flow:

  • Pomocí logických bran (AND/OR/NOT) před přepínačem rozhodněte, kdo ho smí přepínat.
  • Metadata řízená stavem ukládejte pod meta aby překryvy věděly, proč se větev spustila.
  • Exportujte funkční postupy jako šablony, aby je váš tým mohl později znovu importovat.
Zkoušejte dál! Nový Průvodce Event Flow doplňuje tuto příručku, abyste zvládli logickou i stavovou vrstvu.