イベントを作成する
トリガーを選び、実行するステップを追加し、テストを行い、誤って削除した場合は元に戻す
イベントとは1つのルールのことです。配信上で何かが起きたときに、Vfinityが一連のステップを自動実行します。バラのお礼を言ったり、フォロー時に効果音を鳴らしたり、!dance でVTube Studioのホットキーを押したりできます。
イベントの構造
すべてのイベントは3つの要素で構成されています。「トリガー」は何を待つかを指定し、「ルール」は誰がどの頻度で発動できるかを決定し、「アクションステップ」は実際に何が起きるかを定めます。
1つのイベントで、接続しているすべてのプラットフォームに対応できます。ギフトイベントはTikTokのギフトだけでなく、スーパーチャットなど、Twitch、Kick、YouTubeのギフト相当のイベントにも等しく反応します。
シンプルエディターかブループリントかを選ぶ
イベントはシンプルエディターで開き、ステップはリストとして並びます。イベント自身に判断させたい場合は、イベント タブで ブループリントモード をオンにし、ノードとワイヤーのグラフとして組み立てます。
アクションステップのリストを、順番に、同時に、またはランダムに1つ実行します。このページで説明しています。
ノードをワイヤーでつなぎ、分岐、繰り返し、計算、テキスト、変数を使えます。ブループリントイベントをご覧ください。
どちらの種類も同じリストに並び、使えるトリガーとルールも共通です。また、イベントはもう一方の種類に切り替えられます。
イベントを新規作成する
新規イベントを開く
ドックの イベント をクリックし、新しいイベント を選びます。リストの隣にエディターが開きます。ブループリントモード がオンの場合は、代わりにブループリントが開きます。テンプレートから作成したい場合は レシピ をクリックします。
トリガーを選ぶ
発生したとき の下にある イベントの種類 を開き、イベントが反応する対象を選択します。選択に応じて入力項目が切り替わります（ギフトなら対象のギフト、チャットメッセージなら検知するテキストなど）。
アクションステップを追加する
実行する動作 の下にある ステップを追加 をクリックし、テキスト読み上げ や VTSホットキー などのステップ種類を選びます。必要な項目を入力します。同様の手順でステップをさらに追加できます。
保存する
マッピングを追加 をクリックします。イベントがリストに追加され、有効化されて準備が整います。
イベントの種類とステップの種類を選択してください。アプリ内と同様に、選択に応じて項目が切り替わります。
未保存のイベントがあっても、他のタブに切り替えて戻ってきた際にエディターの内容は保持されるため、設定を確認しに行ってから戻ることができます。オンになっているにもかかわらず未設定の項目があるステップは保存できません。該当するステップ名が通知されるので、設定を完了するか、オフにするか、削除してください。
ステップの実行方式を選ぶ
ステップが2つ以上ある場合、リストの上に ステップを実行 の選択肢が表示されます。
| 選択肢 | 動作 |
|---|---|
| 順番に実行 | 各ステップの待機時間を挟みながら、上から順に1つずつ実行します。 |
| 同時に実行 | すべてのステップが同時に開始されます（個別の待機時間は適用されます）。 |
| ランダムに1つ | 設定された 重み に基づいて1つのステップを抽選します。値が大きいほど選ばれやすく、0は選ばれません。 |
各ステップには開始前の待機時間をミリ秒単位で指定する 待機時間 (ミリ秒) と、削除せずに一時停止できるオン/オフスイッチが付いています。グループ ステップを使うと、その中に独自の実行モードを持つ小さなステップリストを入れられるため、「効果音とホットキーを同時に発動し、その後にセリフを読み上げる」といった複雑な構成も可能です。
ステップを並べ替える
ステップのグリップをドラッグして移動するか、グリップにフォーカスを当てて 上 または 下 キーを押します。ステップを右クリックすると、複製、先頭へ移動、別のステップ種類へ 種類を変更、下にステップを追加、削除 などすべての操作が行えます。
ステップをコピー と ステップを貼り付け を使うと、設定を保持したままステップを別のイベントやクイックデッキのパッドへ移植できます。
イベントをテストする
イベントの行にポインターを合わせて再生ボタンをクリックするか、右クリックして 今すぐテスト を選びます。レート制限を無視して、その場ですぐにテスト実行されます。Vfinityが一時停止中であるかイベントがオフになっているなどの理由で実行できない場合は、「イベント」タブにその理由が表示されます。
テスト実行時はイベントのルール（クールダウンなど）はスキップされます。ルールを含めた全体を確認したい場合は、ダッシュボードの イベントシミュレーター から模擬のギフト、いいね、チャットを送信してください。
VTube Studioが起動していない場合
VTube Studioが終了していてもイベントの編集は可能です。「イベント」タブに オフライン編集 と表示され、VTube Studioから直近に取得したホットキー情報が候補として提示されます。効果音や音声読み上げなど、VTube Studioを必要としないステップは起動していなくても動作します。
イベントのオン/オフを切り替える
各行にスイッチが付いています。オフにしたイベントはリストに残ったまま何も実行しなくなります。複製 を行うとオフの状態でコピーが作られるため、設定を編集してから有効化できます。
リストの余白を右クリックすると、表示中の全イベントを一括でオン/オフしたり、特定のトリガー種類だけを絞り込み表示したりできます。
イベントを削除する、元に戻す
行にあるゴミ箱ボタンをクリックするか、右クリックメニューからイベントを削除できます。削除すると 元に戻す ボタン付きの通知が表示され、直前の状態（オン/オフ設定やステップ全体）に復元できます。
複数連続で削除した場合でも、それぞれ個別に元に戻すことができます。