アクションステップを選ぶ
効果音や音声読み上げからVTube Studio、OBS、キー入力、Webhook、アプリコマンドまで、イベントで実行できる操作
アクションステップとは、トリガーが発動したときにイベントが実行する個々の動作のことです。最大20個まで自由に追加・組み合わせが可能です。1つのギフトに対して効果音、読み上げ、VTube Studioのホットキーを同時に発動させることもできます。
ステップの種類を選ぶ
イベントエディターの 実行する動作 で ステップを追加 をクリックし、ステップの種類を選択します。
| 目的 | 使用するステップ |
|---|---|
| 音声でメッセージを読み上げる | テキスト読み上げ |
| 効果音を鳴らす（またはプールから抽選） | 効果音を再生 |
| 画像、GIF、動画を配信画面に表示 | メディアを表示 |
| モデルにアイテムを投げる | 投擲アイテム |
| VTube Studioのホットキーを実行 | VTSホットキー |
| モデルの見た目やポーズを変更 | 表情、色合い、VTSアイテム、モデルを切り替え、パラメーター、モデルを移動、VFXプリセット |
| OBSのシーン切り替えやソース表示 | OBS |
| 他のプログラムにキーボード入力を送信 | キーを押す |
| 外部アプリやサービスに通知 | HTTP Webhook、Streamer.bot アクション |
| ステップ間に待機時間を挟む | 待機 |
| 複数のステップをまとめて制御 | グループ |
| Vfinityの全機能を名前で呼び出す | アプリコマンド |
各ステップは個別に動作します。VTube Studioを必要としないステップはVTube Studioが終了していても実行され、途中の1つのステップが失敗しても残りのステップの実行が止まることはありません。
ブループリントイベントでは、待機 と グループ を除く同じステップを アクション ノードから実行します。待機には 遅延 ノードを使い、グループの役割は シーケンス、並列、ランダム の各ノードが担います。
音声を読み上げる、効果音を鳴らす
テキスト読み上げ は、設定されたTTS音声でテキストを読み上げます。{name}さん、{count}個の{gift}をありがとう！ のようにプレースホルダーを含めて記述すると、トリガーから取得した情報に自動で置き換わります。1分あたりの文字数 で、全視聴者を対象とした1分間の最大読み上げ文字数を制限できます。
読み上げは、設定オーディオボイス で設定したイベントの音量と速度に従います。個別の音量と速度 をオンにすると、大きなギフトへのお礼だけ大きな声にするなど、そのセリフだけの 音量 と 速度 を設定できます。
効果音を再生 は、最大10個のファイルを登録できる サウンドプール を備えており、再生ごとに 重み に基づいて抽選します。出力先 で このアプリのみ、OBSのみ、OBSとこのアプリ のいずれかを指定できます。
どちらのステップも 終了まで待機 をオンにすると、再生や発声が完了するまで次のステップの開始を保留します。
モデルを反応させる
VTSホットキー は、VTube Studioに読み込まれているモデルのホットキーを発動します。時間 (秒) を設定すると、指定秒数後にもう一度ホットキーが押されるため、トグル形式の表情などを自動で元に戻せます。
ホットキーを使わずにモデルを制御できるステップもあります：
- 表情: フェードをかけながら表情をオン/オフ、またはトグル切り替えします。
- 色合い: モデル全体または選択したArtMeshの色を変更したり、虹色のアニメーションを適用したりします。数秒後に元に戻すことも可能です。
- VTSアイテム: VTube Studio内のアイテムや自作画像を配置します。特定のArtMeshに固定することもできます。
- モデルを切り替え: 別のモデルを読み込み、指定時間後に元に戻せます。
- パラメーター: フェイストラッキングに上乗せして、または上書きしてパラメーターの値を変更します。
配信画面に演出を出す
メディアを表示 は、画像、GIF、動画をオーバーレイ上に再生します。これは アクションメディア ウィジェットに表示されるため、事前にOBSでブラウザソースとして追加しておく必要があります。オーバーレイ を参照してください。
投擲アイテム は、あらゆるトリガーからモデルに向けてアイテムを投げます（設定済みアイテム、視聴者のアバター、チャットのエモートなど、一度に最大50個まで）。
OBS は、シーンの切り替え、ソースの表示/非表示、フィルターのオン/オフ、テキストソースの書き換えを行います。戻すまでの時間 を設定すると、数秒後に変更を元に戻すことができます。OBSの制御 を参照してください。
他のプログラムと連携する
キーを押す は、現在アクティブなウィンドウへキーボードの組み合わせ入力を送信します。事前に 設定自動化とルールキーボード操作 の イベントによるキー入力を許可 をオンにしておく必要があります（一部のゲームではシミュレートされたキー入力が無効化される場合があります）。
HTTP Webhook は、JSONボディにプレースホルダーを含めて指定のWebアドレスへリクエストを送信します。Streamer.bot アクション は、接続中のStreamer.botでアクションを実行します。Streamer.bot を参照してください。
Vfinity自身を制御する
アプリコマンド は、Vfinityが提供するあらゆるコマンドを実行します（クイックデッキのパッドを押す、タイマーに時間を追加する、アラートをスキップする、イベントマッピングを実行 で別のイベントを呼び出すなど）。イベント同士の相互呼び出しは最大4回で自動停止するため、無限ループに陥る心配はありません。
待機 は指定した時間（最大10分）処理を一時停止します。グループ は独自の実行モードを持つ小さなステップリストを1階層だけ内包できます。
設定例：大当たり演出
大当たり（Jackpot）レシピは、複数のステップを組み合わせる好例です。1,000ダイヤ以上のギフトで発動し、以下の3ステップを順番に実行します：
1. 効果音を再生 選んだファンファーレ
2. メディアを表示 選んだ動画クリップ
3. テキスト読み上げ すごい！{name}さん、{gift}を本当にありがとう！ステップを実行 を 同時に実行 に切り替えると、3つの動作がすべて同時に開始されます。
ステップの再利用
完成したステップを右クリックして ステップをコピー を選び、別のイベントやクイックデッキのパッドで ステップを貼り付け を実行すると、すべての設定を保ったまま複製できます。