Triggers

トリガーはストリームイベントに基づいてアクションを自動化する機能です。Xが発生すると、Yを実行します。コードは必要ありません — ダッシュボードからトリガー規則を構築します。

How Triggers Work

トリガーには3つの部分があります。

1. イベント — トリガーを発火する要因（チャットメッセージ、フォロワー、サブ、など）
2. 条件 — オプションのフィルターが真となる場合、トリガーが進む
3. アクション — トリガーが発火した場合のアクション

例： チャットメッセージが50人以上のフォロワーが raid → ライドサウンドを再生 → ライドGIFを表示 → チャットに感謝のメッセージを送る.

Trigger Events

チャットイベント

• メッセージ送信 (キーワードまたはコマンドにマッチ)
• TTSメッセージが_queue'd
• ユーザーが特定のコマンドを使用

ストリームイベント

• 新しいフォロワー
• 新しいサブスクリプション
• リスブ
• ギフトサブ (シングルまたはバッチ)
• ライドを受け取る
• ドonation/ティップを受け取る
• スーパーチャット (YouTube)
• ギフト (TikTok)

マニュアル/スケジュール

• ダッシュボードボタンクリック (マニュアルにトリガーを発火)
• タイマー (ストリーム中にN分間隔でトリガーを発火)

Conditions

条件はトリガーが発火する時をフィルタリングする:

• 量の閾値 — 例えば、50人以上のフォロワー、5ドル以上の寄付
• メッセージに含む — チャットメッセージ内のテキストまたはレグエキスマッチ
• ユーザーにマッチ — 特定のユーザーまたはパターンをターゲットにする
• プラットフォーム — 特定のプラットフォームから発生するイベントのみ
• 時間 — certain時間に制限する

複数の条件をAND/OANDロジックで組み合わせることができます。

Actions

トリガーが発火した場合、1つまたは複数のアクションを実行できます:

アクション	説明
Play media	サウンド、画像、またはビデオをメディアライブラリから再生する。
Send chat message	チャットにテキストを送信。 {username}, {amount}, {message} プレイスホルダーを使用できます。
Run TTS	TTSメッセージを強制的に実行 (キューまたはキューに加算)。
Fire alert	オーバーレイに警告を表示する。
Switch Compositor preset	オーバーレイのレイアウトを変更する。
Toggle widget	特定のウィジェットを表示または非表示にする。
HTTP request	ウェブhook URL (POST with event data) を呼び出します。

アクションはシーケンスで実行されます。遅延 (例: 2秒間待ってからチャットメッセージを送信) を追加できます。

Creating a Trigger

1. ダッシュボードのサイドバーで Triggers を開く。
2. New Trigger をクリックします。 3.名前を付ける。
3. Event のタイプを選択します。
4. 必要に応じて Conditions を追加します。
5. 1つまたは複数の Actions を追加します。
6. 保存します。

トリガーは即時活性化されます。 Test ボタンをクリックして、トリガーが機能することを確認するには。

Trigger Order

複数のトリガーが同じイベントを発生すると、すべてが発火します。 orderが重要な場合 (例: サウンドを再生する前にチャットメッセージを送る場合)、トリガー内のアクションの連鎖を使用するのではなく、個々のトリガーを使用する必要があります。