トリガー
イベントが待ち受ける全トリガー、その設定、対応プラットフォーム、埋め込める変数
イベントエディターの イベントの種類 にある全トリガーの一覧です。それぞれの設定項目、イベントを送るプラットフォーム、ステップで使えるテンプレート変数を確認できます。
メニューの最初には配信中の出来事が並び、最後には入力したテキストで照合する API トリガー と チャットメッセージ があります。選び方は トリガーを選ぶ を参照してください。
イベントの種類とステップの種類を選択してください。アプリ内と同様に、選択に応じて項目が切り替わります。
視聴者のアクティビティ
| トリガー | 発動する時 | 送信元 | 固有の設定 |
|---|---|---|---|
| ギフト | ギフト到着時、またはコンボ終了時 | TikTok LIVE、Twitch、Kick、YouTube | ギフト名、カタログ、一致条件、最低価値 |
| いいね | 視聴者が画面をタップした時 | TikTok LIVE | なし |
| フォロー | フォローされた時 | TikTok LIVE、Twitch、Kick | なし |
| シェア | LIVE がシェアされた時 | TikTok LIVE | なし |
| チャットメッセージ | チャットが指定したテキストに一致した時 | TikTok LIVE、Twitch、Kick、YouTube | トリガー文字列、一致モード、大文字と小文字を区別、コマンドごとの消費ポイント、最初のコマンド引数をモデル移動に使う |
| この配信での初コメント | 視聴者が配信で初めてコメントした時 | TikTok LIVE、Twitch、Kick、YouTube | なし |
| 視聴者の入室 | 視聴者が LIVE に入った時 | TikTok LIVE | なし |
| サブスク | サブスク登録された時、または YouTube でメンバーが加入したりマイルストーンに達したりした時 | TikTok LIVE、Twitch、Kick、YouTube | なし |
| Super Fan | 視聴者が Super Fan になった時 | TikTok LIVE | なし |
| サブスクライバーエモート | サブスクライバーがエモートを送った時 | TikTok LIVE | なし |
| 宝箱 | 視聴者が宝箱を置いた時 | TikTok LIVE | なし |
| LIVE 質問 | 視聴者が質問を送った時 | TikTok LIVE | なし |
| レイド Twitch 限定 | 別のチャンネルからレイドされた時 | Twitch | なし |
| Twitchチャンネルポイント Twitch 限定 | 視聴者がチャンネルポイントの報酬を交換した時 | Twitch | 報酬メニュー、すべての報酬、報酬を更新 |
視聴者の入室 は同じ視聴者に対して 30 秒に 1 回だけ発動します。すぐに出入りしても重複しません。この配信での初コメント は配信ごとに最大 50,000 人を記憶します。
Twitch、Kick、YouTube からのギフト
Twitch、Kick、YouTube での購入は、設定ポイントイベントの価値 で決めたダイヤ価値を持つ ギフト として届きます。ギフト名 に次の名前を入力すると個別に反応できます。
| ギフト名 | 内容 |
|---|---|
Cheer | Twitch の Bits |
Gift Sub | Twitch または Kick のギフトサブスク、または YouTube のメンバーシップのギフト |
Kicks | Kick 独自のギフト通貨 |
Super Chat | YouTube のスーパーチャット。金額に応じたダイヤ価値になります |
Super Sticker | YouTube のスーパーステッカー。金額に応じたダイヤ価値になります |
| ギフトそのものの名前 | YouTube のジュエルのギフト。ダイヤ価値はありません |
| 報酬のタイトル | Twitch のチャンネルポイント交換、または Kick の報酬 |
Cheer、Kicks のギフト、スーパーチャットに添えられたメッセージは {comment} に入ります。スーパーチャットのメッセージは、ギフトのあとにチャットメッセージとしても届きます。
Twitch チャンネルポイントと YouTube メンバーシップ
Twitchチャンネルポイント は報酬を ID で照合するため、Twitch で報酬の名前を変えてもそのまま動作します。すべての報酬 はすべての交換に一致し、Twitch が同じ交換を 2 回通知しても実行は 1 回だけです。Twitch に接続し、チャンネルの配信者としてサインインしている間は、カスタム報酬が消費ポイントとともにメニューに表示されます。
YouTube では、新しいメンバーの加入とメンバーシップのマイルストーンで サブスク が発動します。メンバーシップのギフトを受け取った視聴者 1 人ごとにも発動します。チャンネルメンバーは これを実行できる人 でサブスクライバーとして扱われます。
配信の節目とマイルストーン
| トリガー | 発動する時 | 固有の設定 |
|---|---|---|
| 配信開始 | いずれかのプラットフォームで新しい LIVE が始まった時、または開始前から参加していた YouTube の予約配信が始まった時 | なし |
| 配信終了 | LIVE が終わった時。YouTube では 1 分以内に発動します | なし |
| ルームのいいね目標達成 | ルームの累計いいねがしきい値を超えた時 | しきい値、倍数ごとに繰り返す |
| 視聴者数マイルストーン | ルームの視聴者数がしきい値を超えた時 | しきい値、倍数ごとに繰り返す |
| フォロワー数マイルストーン | フォロワー数がしきい値を超えた時 | しきい値、倍数ごとに繰り返す |
| バトル | TikTok バトルの開始、更新、終了 | バトルの段階、バトルの結果（任意） |
| TikTok LIVE ゴール | TikTok LIVE ゴールが変化した時 | LIVE ゴール達成時のみ |
| ハイプトレイン Twitch 限定 | ハイプトレインの開始または終了 | バトルの段階：begin または end |
| 数分ごと | カウントダウンが終わった時 | 実行間隔、ランダムな追加時間、配信中のみ実行 |
しきい値 の初期値は 100 で、1 以上の整数を受け付けます。参加時のルーム値を読み取ってそこから集計するため、途中参加しても過去のマイルストーンを再実行しません。倍数ごとに繰り返す がオフなら配信ごとに 1 回です。ルームのいいね目標達成 は TikTok の累計いいねを使うため、Twitch、Kick、YouTube では発動しません。
バトルの段階 は start、progress、end、バトルの結果（任意） は なし、win、lose、draw から選びます。レイド、ハイプトレイン、Twitchチャンネルポイント は Twitch に一度でも接続するとメニューに表示されます。
数分ごと
| フィールド | 範囲 | 既定値 |
|---|---|---|
| 実行間隔 | 1～240 分。クイック選択 は 5、10、15、30、60 分 | 10 分 |
| ランダムな追加時間 | 0～実行間隔と同じ分数 | 0 |
| 配信中のみ実行 | オン／オフ | オン |
最初の実行はカウントダウン開始から 1 間隔後で、すぐには実行されません。Vfinity の一時停止中に来た回は飛ばされ、緊急停止ではすべてのカウントダウンが最初から始まります。
ゲームとオーバーレイウィジェット
オーバーレイ タブのウィジェットで結果が出ると発動します。
| トリガー | 発動する時 | キーフィールドで絞り込む値 |
|---|---|---|
| オーバーレイの目標達成 | ゴールウィジェットが目標値に到達 | goal1 などゴールのウィジェット ID |
| タイマーがゼロに到達 | カウントダウンがゼロ、またはカウントアップが目標値に到達 | 空欄 |
| ルーレットの結果 | ルーレットが停止 | 選択肢の結果 ID |
| プレゼント企画の当選者 | リールが当選者で停止 | キーフィールドなし |
| 綱引きの勝利 | ラウンドが勝者ありで終了 | 1、2、またはチーム名 |
| 盛り上がりレベル到達 | メーターが新しいレベルに上昇 | レベル番号 1～5 または名前 |
キーフィールドは ウィジェット ID または結果キー（空欄ですべて） です。チーム名とレベル名の大文字・小文字は区別しません。盛り上がりメーターが同じレベルで再発動するには、そのレベルより 10% 以上下がる必要があります。
入力したテキストで照合
| トリガー | フィールド | 一致条件 |
|---|---|---|
| API トリガー | トリガー名 | ローカル API またはトリガー API に送られた name。大文字・小文字は区別しません |
| チャットメッセージ | トリガー文字列 | 次の一致モードでチャットを照合 |
チャットの一致モード
| モード | 一致する条件 |
|---|---|
| 含む（既定） | メッセージ内のどこかに指定テキストがある |
| 完全一致 | メッセージが指定テキストそのもの |
| 先頭一致 | 指定テキストで始まる |
| コマンドと引数 | !spin のようなコマンドで始まる。後続の単語は引数 |
| 制限付き正規表現 | パターンに一致。キャプチャーは引数になる |
大文字と小文字を区別 をオンにすると区別して照合します。正規表現ではアンカー、文字クラス、キャプチャー、32 回までの固定繰り返しを使えます。
コマンドごとの消費ポイント の範囲は 0～1,000,000 です。残高不足の視聴者はイベントを起動できません。待機中の実行が開始前に破棄された場合はポイントが返却されます。
最初のコマンド引数をモデル移動に使う は、最初の引数をすべての モデルを移動 ステップの 回転（°）、サイズ、位置 X、位置 Y に渡します。!spin 90 はモデルを 90° 回転させます。数値でない場合はイベントを止め、ポイントも消費しません。
全トリガーに共通する設定
イベントエディターの 詳細設定 にあります。
| フィールド | 対象 | 範囲・選択肢 |
|---|---|---|
| 最低ギフト数、最低いいね数、最低回数 | マイルストーンと 数分ごと を除く全トリガー | 0 以上 |
| 遅延（ミリ秒） | 全トリガー | 0 以上。アクションリスト全体の前に待機 |
| 集計方法 | 数分ごと を除く全トリガー | 視聴者ごとに集計、全視聴者で集計 |
| レート制限を有効にする | 全トリガー | 時間枠（秒） 内の 最大発動回数。最初は 60 秒で 5 回 |
| 数量の扱い | ギフト | ギフトイベントごとに 1 回、アクションを xN 回繰り返す、継続時間を xN 倍 |
| 集計単位 | 全視聴者で集計 の ギフト | ギフト または ダイヤ |
| 上限（◆） | ギフト | 1～1,000,000 ダイヤ、または 制限なし |
| 価値の基準 | ギフト | コンボ全体（ギフト × 個数） または ギフト 1 個 |
集計単位 が ダイヤ の場合、全員のダイヤ合計が 集めるダイヤ数 を超えるたびに発動します。1 コンボにつき最大 20 回です。
ステップの下の 設定 には これを実行できる人、クールダウン、アクションキュー のルールがあります。ルールとクールダウン に詳しく説明しています。
| ルール | 範囲 | 既定値 |
|---|---|---|
| これを実行できる人 | フォロワー、フレンド、サブスクライバー、Super Fan、モデレーター、ファンクラブメンバー、トップギフター | 全員 |
| トップギフターの人数 | 1～100 | 3 |
| 常に許可、許可しない | 各最大 200 名 | 空欄 |
| 視聴者ごと（秒）、全員（秒） | 0～86,400 | 0 |
| クールダウン中 | トリガーを無視 または 待機終了後に実行 | トリガーを無視 |
| キューレーン（同名なら順番に実行） | 最大 64 文字 | default |
| キュー優先度（高いものから実行） | −1000～1000 | 0 |
| 待機中の実行を破棄する秒数 | 1～3600 | 120 |
各トリガーが埋める変数
視聴者を特定できるトリガーは {name}、{nickname}、{uniqueId}、{points} を埋め、すべてのトリガーが {trigger} を埋めます。次は固有の変数です。
| トリガー | 追加される変数 |
|---|---|
| ギフト | {gift}、{count}、{diamonds}、{totalDiamonds}。メッセージ付きのギフトでは {comment} も |
| Twitchチャンネルポイント | {rewardName}、{rewardCost}、{rewardId}、{redemptionId}。テキスト入力を求める報酬では {comment} も |
| いいね | {count}、{likes}、{totalLikes} |
| チャットメッセージ | {comment}、{args}、{arg1}～{arg9} |
| この配信での初コメント | {comment} |
| サブスク | {months} |
| レイド | {viewers} |
| 宝箱 | {coins} |
| サブスクライバーエモート | {emoteUrl} |
| LIVE 質問 | {questionText} |
| ハイプトレイン | {phase}、{level}、{total} |
| ルームのいいね目標達成 | {totalLikes} |
| 視聴者数マイルストーン | {viewers} |
| フォロワー数マイルストーン | {followers} |
| オーバーレイの目標達成 | {value}、{target}、{cycle} |
| ルーレットの結果 | {result} |
| プレゼント企画の当選者 | {winner}、{tickets}、{entrants} |
| 綱引きの勝利 | {team}、{score}、{otherScore} |
| 盛り上がりレベル到達 | {level}、{levelName} |
| API トリガー | 送信された data の最上位にある文字列、数値、真偽値の全フィールド |
各変数の値は テンプレート変数 を参照してください。