狀態節點實用指南

狀態節點

• 位於畫布上。
• 儲存值（ON/OFF、計數、時間戳記或使用者）。
• Gate、Counter 和 Rate Limiter 可以在一般事件路徑中執行。
• User Memory 是其他節點參照的共用中心。

狀態動作

• 放在下游。
• 讀取或變更已儲存值（設為 ON、加 1、記憶、抽獎、重設等）。
• 可以位於流程中的任意位置，只需選擇相符的節點名稱。

適合

• 聊天命令的冷卻時間。
• 手動切換（啟用/停用疊加畫面）。
• 維護時段（在 BRB 場景中暫停功能）。

關鍵動作

• Set Gate State— 切換 ON 或 OFF。
• Reset State Node— 還原預設值（通常為 ON）。

使用情境

• 每第 N 位聊天者觸發一次獎品。
• 追蹤社群目標進度。
• 儲存透過命令兌換的點數。

操作

• Increment Counter— 加上或減去自訂數值。
• Set Counter Value— 跳至指定數字。
• Reset State Node— 還原預設起始值。

適用需求

• 「每分鐘只允許五個抽獎項目。」
• 「每 10 秒呼叫一次 API。」
• 「如果疊加畫面已經忙碌，則捨棄提醒。」

設定

• 設定允許的最大事件數。
• 選擇時間區間（秒）。
• 決定將超出限制的事件排入佇列還是捨棄。

適合

• 以禮物或徽章為依據的資格。
• 記住按讚、報名或參加過的觀眾。
• 每人一份資格的抽獎。
• 為不同活動使用獨立清單。

動作

• Remember User 和 Forget User.
• User Is Remembered.
• Pick Random User.
• Clear All Users 或 Reset State Node.

命令冷卻

1. 名為「commandCooldown」的開關節點。
2. 觸發條件 → 開關 → 回覆。
3. Set Gate OFF → Delay → Set Gate ON。
4. 如果需要，在 false 輸出上新增聊天訊息「Cooldown active」。

限量贈品

1. 計數器預設值為 0，目標為 3。
2. 每次兌換後遞增。
3. 當 value ≥ 3 時，分支至「Sorry, all gone」。
4. 在直播結束時使用 Reset 動作。

觀眾開關

1. 名為「overlayToggle」的開關。
2. !overlay on 命令 → Set Gate ON。
3. !overlay off 命令 → Set Gate OFF。
4. 所有疊加畫面觸發條件都通過該開關。