ブループリントイベント
ノードとワイヤーのグラフでイベントを組み立て、分岐、繰り返し、カウント、記憶を行えます
ブループリントモードでは、ステップのリストの代わりに、ノードとワイヤーのグラフでイベントを組み立てます。1つのイベントが自分で判断できるようになり、大きなギフトには特別なお礼をしたり、目標に向けてカウントしたり、2つのリアクションを交互に実行したりできます。
ブループリントが動くしくみ
すべてのグラフは イベント ノードから始まり、トリガーが発動するたびに実行されます。白い実行ワイヤーは、次に何を実行するかを示します。色付きのデータワイヤーは値を運びます。赤は真偽値、緑は数値、ピンクはテキストです。
真サウンドを再生
トリガー、ルール、クールダウン、キューはイベント側に残るため、シンプルなイベントと同じように機能します。グラフになるのはステップのリストだけで、1つのイベントが持つグラフは1つです。
イベントをブループリントにする
イベント タブで、見出しの横にある ブループリントモード をオンにします。以降は 新しいイベント でブループリントが開きます。シンプルなイベントとブループリントはリストに並んで表示され、ブループリントの行には ブループリント のチップが付きます。
モードがオンのとき、シンプルエディターには、新しいイベントなら ブループリントとして開く、保存済みのイベントなら ブループリントに変換 が表示されます。シンプルなイベントの行の右クリックメニューにも同じ項目があります。変換したコピーは未保存の状態で開き、元と同じステップを実行します。
シンプルなイベントに戻す
ブループリントの行を右クリックし、シンプルなイベントに変換 を選びます。すぐに切り替わり、通知に 元に戻す が表示されます。ブランチや変数など、リストで表せないものをグラフで使っている場合、この項目は淡色表示になります。ポインターを合わせると理由を確認できます。
エディターの画面構成を知る
ブループリントは全画面で開き、ドックと「イベント」のリストは表示されなくなります。ヘッダーには インポート、エクスポート、テスト値、保存して実行、保存、キャンセル が並び、その横のステータスには 問題なし、またはエラーと警告の件数が表示されます。
- 左側の マイブループリント には、変数 とすべてのノードが一覧表示されます。
- 右側の 詳細 では、選択したものを編集します。イベント ノードを選ぶとトリガーとそのルールを変更でき、変更後に トリガーを適用 をクリックします。
- 下部の コンパイル結果 には、すべての問題が一覧表示されます。項目をクリックすると、そのノードへ移動します。
サイドパネルの端をドラッグするとサイズを変更でき、端をダブルクリックすると元の幅に戻ります。ウィンドウの幅が狭いときは、マイブループリントがアイコンの列になり、詳細は右からスライドして表示されます。
ノードを追加する
キャンバスのツールバーで ノードを追加 をクリックするか、Shift+A を押すか、キャンバスの何もない場所を右クリックします。ノードを検索 に入力して Enter を押します。ピンからワイヤーを何もない場所までドラッグすると、そのワイヤーに合うノードだけが一覧に表示され、選んだノードに自動でつながります。
| 種類 | ノード |
|---|---|
| フロー制御 | ブランチ、シーケンス、並列、ランダム、遅延、For ループ、1 回だけ実行、N 回だけ実行、フリップフロップ、テキストでスイッチ、数値でスイッチ |
| トリガーデータ | トリガーデータを取得、トリガーのフィールドを取得、役割を持つか |
| 数学 | 加算、減算、乗算、除算、剰余、最小、最大、クランプ、丸め、絶対値、乱数 |
| 論理 | 比較、AND、OR、NOT |
| テキスト | テキストをフォーマット、テキストを比較、テキストを結合、大文字/小文字を変換、テキストの長さ、数値に変換 |
| 変数 | 変数を取得、変数を設定 |
| アクション | アクション（待機 と グループ を除くすべてのステップ）、別のイベントを実行 |
| ユーティリティ | ログ出力、コメント、リルート |
遅延 は0〜600秒待ち、For ループ は最大100回まで繰り返します。アクション ノードは 次へ から先へ進みます。ステップが失敗したときは、失敗 ピンにワイヤーがつながっていれば、そちらへ進みます。読み上げるセリフの テキスト のように、ワイヤーから値を受け取れるステップもあります。
ノードをワイヤーでつなぐ
出力ピンから入力ピンへドラッグします。ポインターの横のバッジには、つなげる場合はチェックマークと接続先のピンが、つなげない場合は×印とその理由が表示されます。たとえば「このピンは数値を受け取ります。テキストから読み取るには『数値に変換』を使ってください。」のように表示されます。
数値や真偽値は、自動でテキストに変換されます。実行の出力とデータの入力にはワイヤーを1本ずつしかつなげないため、新しいワイヤーをつなぐと前のワイヤーと置き換わります。Alt を押しながらピンをクリックすると、そのピンのワイヤーを切断できます。
変数に値を保存する
マイブループリント で 変数を追加 をクリックし、型、初期値、スコープ を設定します。スコープは、このブループリントだけで使う イベント か、同じ名前ですべてのブループリントイベントと共有する グローバル から選びます。取得 と 設定 で、その変数のノードを追加できます。
現在値 には、このイベントの直近の実行で残った変数の値が表示されます。値はアプリを閉じるまで保持されます。現在値 の横にあるリセットの矢印をクリックすると、初期値に戻ります。
ブループリントをテストする
テスト値 をクリックし、視聴者名、ギフト、ダイヤ、コメントなど、トリガーが運んできたことにする値を選びます。続けて 保存して実行 をクリックすると、Vfinityはイベントを保存し、テストとして1回実行します。行の再生ボタンと同じ動作です。
実行が通過したノードは順に光り、失敗したノードは赤く点滅します。ログ出力 ノードは デバッグコンソール に書き出します。エラーがあってもブループリントは保存できますが、エラーが残っている間は行に ブループリントを修正 と表示されます。
元に戻す、整える
元に戻す と やり直し は、適用したトリガーの変更も含め、グラフへのすべての変更に使えます。整列 を使うと、実行ワイヤーに沿ってグラフが左から右へ並びます。C を押すと、選択したノードを コメント で囲めます。
1つのイベントを共有する
エクスポート を使うと、イベントをトリガー、ブループリント、使用しているサウンドやメディアと一緒にファイルに保存できます。未保存の変更は先に保存されます。別のPCでは新しいブループリントを開いて インポート をクリックします。エディターに表示中の内容がファイルのイベントに置き換わり、シンプルなイベントは同じステップを実行するブループリントとして読み込まれます。
インポートする前にVTube Studioに接続してください。各 ホットキーを実行 アクションは、読み込まれているモデルのホットキーと名前で照合され、見つからないものは通知に表示されます。保存 をクリックするまで、何も保存されません。
バックアップファイルに含める項目を選択してください。
以前のビルドについて
Alpha 0.4.0より前のVfinityでは、ブループリントイベントは実行されません。ブループリントのファイルは、Alpha 0.4.0以降を使っている人と共有してください。