VTube Studioを接続する
VTube StudioのプラグインAPIをオンにし、Vfinityを一度承認してVTSピルを緑色にする
VfinityはVTube StudioのプラグインAPIを介してモデルを操作します。APIをオンにして初回の承認を行うだけで、イベントからホットキーや表情の切り替え、モデルの動きを制御できるようになります。
プラグインAPIをオンにする
VTube Studioの設定を開く
VTube Studioで歯車アイコンをクリックし、設定を開きます。
APIを開始する
プラグインAPIの項目を探し、APIを開始する をオンにします。表示されているポート番号を確認します（変更していない場合は8001です）。
Vfinityを接続して承認する
VTube Studioカードを開く
Vfinityで 設定接続 に移動し、アプリ の下にある VTube Studio API を見つけます。IPアドレス と ポート は初期状態で localhost と 8001 になっています。VTube Studio側で異なるポート番号が表示されていた場合は、ここにその番号を入力します。
接続する
VTSに接続 をクリックします。タイトルバーの VTS ピルを右クリックして 接続 を選ぶこともできます。
プラグインを許可する
VTube Studio側でVfinityを許可するか尋ねられます。許可 を選択してください。画面上に何も表示されない場合は、別モニターやVTube Studio本体の背面にウィンドウが隠れていないか確認してください。
Vfinityの承認は初回の一度だけです。以降は確認なしで接続されるようになり、起動時に接続 が有効であればVfinityの起動時に毎回自動接続されます。
VTube Studioを別のPCで動作させている場合は、localhost の代わりにそのPCのIPアドレスを IPアドレス に入力します。
緑色のピルを確認する
タイトルバーの VTS ピルで接続状態を一目で確認できます。VTube StudioでVfinityが承認されると緑色に変わり、ポインターを合わせると詳しい状態がテキストで表示されます。
| ピルの色 | 意味 |
|---|---|
| 緑 | 接続・承認完了。イベントからモデルを動かせます。 |
| 黄 | 接続中、または切断後の再試行中。ラベルの横に再試行回数が表示されます。 |
| 赤 | 未接続。 |
ピルを右クリックすると、切断、再接続、または「設定」内のVTube Studioカードを開く操作が行えます。
このPC
Vfinityはポート8001でVTube Studio APIに接続し、ホットキーの実行やモデルの操作を行います。
Vfinityはポート4455でOBS内蔵のWebSocketサーバーに接続し、シーンの切り替えやソースの表示を行います。
OBSブラウザソースはVfinity自体のサーバー（ポート21424）を開き、投擲、アラート、ウィジェットを描画します。
自作スクリプトはトークンを用いて同じポート21424のローカルAPIにアクセスします。
TikTok LIVE、Twitch、Kick、YouTubeはインターネット経由で通信します。各接続はVfinity自身が直接開始します。
矢印：接続を開始する側
ポート：待ち受ける側
取得された情報を確認する
ダッシュボードの VTube Studioモデル カードには、現在読み込まれているモデル名と、イベントエディターで利用可能な表情、モデル、アイテムファイル、パラメーター、ArtMeshの数が表示されます。これらのリストはモデルを切り替えた際に自動で追従します。
- リストを更新: 表示内容が古い場合に最新情報を取り直します。
- 再接続: VTube Studioが応答しなくなった場合に接続を最初からやり直します。
- VTube Studioアイテムとしての画像: 初回のみ追加の権限が必要です。VTube Studioで許可 をクリックしてダイアログを承認すると、画像をアイテムとして読み込めるようになります。
- 被弾時のひるみをテスト: ギフトが当たったときの小さなひるみ動作を再生し、実際にアイテムを投げずにモデルの反応をテストできます。