状態ノード活用ガイド

状態ノード

• キャンバス上に配置します。
• 値（ON／OFF、カウント、タイムスタンプ、ユーザー）を保持します。
• Gate、Counter、Rate Limiterは、通常のイベント経路内で動作できます。
• User Memoryは、ほかのノードが参照する共有の保存場所です。

状態アクション

• 後続に配置します。
• 保存された値を読み取り、または変更します（ONにする、1を加算、記録、抽選、リセットなど）。
• フロー内のどこにでも配置できます。対応するノード名を選ぶだけです。

適した用途

• チャットコマンドのクールダウン。
• 手動の切り替え（オーバーレイの有効／無効）。
• メンテナンス時間（離席シーン中に機能を一時停止するなど）。

主なアクション

• Set Gate State— ONまたはOFFに切り替えます。
• Reset State Node— 既定値（通常はON）に戻します。

使用例

• チャット参加者がN人増えるごとに賞品を出す。
• コミュニティ目標への進捗を記録する。
• コマンドで交換されたポイントを記録する。

アクション

• Increment Counter— 指定した量を加算または減算します。
• Set Counter Value— 指定した数値に設定します。
• Reset State Node— 既定の開始値に戻します。

こんな用途に便利

• 「抽選への応募は1分あたり5件まで。」
• 「API呼び出しは10秒に1回。」
• 「オーバーレイが使用中ならアラートを破棄する。」

設定

• 許可するイベントの最大数を設定します。
• 時間枠を秒単位で指定します。
• 上限を超えたイベントを待機させるか、破棄するかを決めます。

適した用途

• ギフトやバッジに基づく参加資格。
• いいね、応募、参加をした視聴者を記録する。
• 重複応募のない抽選。
• キャンペーンごとに別のリストを使う。

操作

• 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出力に「クールダウン中です」というチャットメッセージを追加します。

数量限定の無料配布

1. カウンターの初期値は0、目標値は3。
2. 交換のたびに加算します。
3. 値が3以上になったら、「申し訳ありません、すべて配布済みです」に分岐します。
4. 配信終了時にResetアクションを使用します。

視聴者による切り替え

1. 「overlayToggle」という名前のスイッチ。
2. !overlay on コマンド → Set Gate ON。
3. !overlay off コマンド → Set Gate OFF。
4. すべてのオーバーレイトリガーをスイッチに通します。