VTubeStudio連携
前提条件
- VTubeStudioが動作することが必要です
- VTubeStudioでAPIの有効化が必要です
- このプラグインは ゆかコネNEOv2.0.17より同梱されています
このプラグインで出来ること¶
- 音声認識結果に応じてVTubeStudioのキーバインドアクションを自動実行
- VTubeStudioに字幕表示（日本語・英語・中国語・韓国語・スペイン語・フランス語対応）
- キーワードや話者によるアクション制御
- リアルタイムでアバターの表情・モーションを変更
- 多言語翻訳結果の自動表示
有効化¶
- プラグインを使うチェックをONにしてください。
設定¶
基本接続設定¶
| 設定項目 | 詳細説明 | 設定例 | 重要度 |
|---|---|---|---|
| Port | VTubeStudioとWebSocket通信するポート番号 ・VTubeStudio側のAPI設定と一致させる ・通常8001番を使用 |
8001 |
★★★ |
| 文章を表示 | VTubeStudioに字幕表示ウィンドウを出すかの設定 ・ONで字幕ウィンドウが表示される ・配信で字幕を表示したい場合にON |
チェックON/OFF | ★★☆ |
| 表示内容 | 字幕に表示する言語を選択 ・母国語: 音声認識結果をそのまま表示 ・翻訳1-4: 各翻訳結果を表示 |
母国語/翻訳1/翻訳2/翻訳3/翻訳4 | ★★☆ |
ルール¶
- ルールは、条件に一致したときにそのデータを送付することができる「仕掛け」です
- 条件成立したときにアバターにアクションを起こさせることができます。
| 設定 | 意味 |
|---|---|
| 有効(Enabled) | この条件を有効化します |
| モード(Mode) | 条件の判断モードを指定します |
| 対象 | 対象にする言語を決めます（母国語、翻訳１～４） |
| 起動フレーズ | 判断に使う起動キーワードです |
| Key Action | VTubeStudioに設定しているキーバインドの設定名を入れます |
| 対象者 | 話者名に指定文字が含まれているときに反応します。空欄の場合は全員が対象です |
| APIタグ | APIから呼び出すときにつかうタグ名です |
VTubeStudio側の設定手順¶
API設定の有効化¶
- VTubeStudioを起動
- 設定を開く: 右上の歯車アイコンをクリック
- 一般設定 → APIを開く
- 「APIを有効にする」をチェック
- ポート設定を確認: 通常8001番（ゆかコネ設定と一致させる）
- 「外部からのAPI接続を許可する」をチェック（必要に応じて）
キーバインド設定（表情・モーション制御用）¶
- 設定 → キーバインドを開く
- 「+」ボタンで新しいキーバインドを追加
- 名前を設定（例：「笑顔」「驚き」「手を振る」）
- トリガー設定: 「ホットキー」を選択
- アクション設定: 表情やモーションを選択
- 保存
よく使うキーバインド例¶
| キーバインド名 | 用途 | アクション例 |
|---|---|---|
| 笑顔 | 嬉しい発言時 | Happy表情に変更 |
| 驚き | びっくり発言時 | Surprised表情 |
| 怒り | 怒った発言時 | Angry表情 |
| 手を振る | 挨拶時 | Wave手のモーション |
| お辞儀 | 感謝時 | Bowモーション |
使い方手順¶
初回接続設定¶
- VTubeStudioを起動してAPI設定を有効化（上記参照）
- ゆかコネでプラグインを有効化
- ポート番号を確認・設定（デフォルト8001）
- 「Open」ボタンを押して接続開始
- VTubeStudio側で許可ダイアログが表示される
- 「許可」をクリックして認証完了
- 「Yukarinette Connector NEO」が接続済みアプリに表示されることを確認
日常使用¶
- 音声認識を開始
- 設定したキーワードを話す
- VTubeStudioでキーバインドアクションが自動実行される
- 字幕表示を有効にしている場合は字幕も表示される
字幕表示について¶
表示設定¶
- 表示時間: ゆかコネ本体設定の「表示時間」に基づいて表示
- ウィンドウサイズ: 字幕レイアウト詳細の「ウィンドウの高さ」が適用
- 多言語対応: 7言語（日本語、英語、中国語、韓国語、スペイン語、フランス語、ロシア語）
字幕の活用例¶
- 配信での多言語対応
- VTuberの発言内容を視聴者に分かりやすく表示
- 翻訳結果を同時表示して国際的な配信
よくある問題と解決方法¶
接続エラー¶
| 症状 | 原因 | 解決方法 |
|---|---|---|
| 「接続できません」エラー | VTubeStudioのAPI無効 | VTubeStudio設定でAPI有効化 |
| 「認証失敗」エラー | API許可していない | VTubeStudioで接続許可 |
| 「ポートエラー」 | ポート番号不一致 | 両側のポート設定を確認 |
キーバインドが動作しない¶
| 症状 | 原因 | 解決方法 |
|---|---|---|
| アクションが実行されない | キーバインド名が間違い | VTubeStudioでキーバインド名を確認 |
| 一部のアクションのみ実行 | モデルが対応していない | モデル固有の表情・モーション確認 |
| 反応が遅い | ネットワーク遅延 | ローカル接続（127.0.0.1）確認 |
字幕表示の問題¶
| 症状 | 原因 | 解決方法 |
|---|---|---|
| 字幕が表示されない | 「文章を表示」OFF | 設定で「文章を表示」をON |
| 文字化けする | 文字コード問題 | VTubeStudioを再起動 |
| 表示時間が短い | 本体設定の表示時間 | ゆかコネ本体で表示時間延長 |
設定確認チェックリスト¶
VTubeStudio側¶
- [ ] VTubeStudioが起動している
- [ ] API機能が有効になっている
- [ ] ポート番号が正しい（通常8001）
- [ ] 外部接続が許可されている
- [ ] キーバインドが正しく設定されている
- [ ] 使用する表情・モーションがモデルに対応している
ゆかコネ側¶
- [ ] プラグインが有効になっている
- [ ] ポート番号がVTubeStudioと一致している
- [ ] ルール設定でキーバインド名が正確
- [ ] 起動フレーズが適切に設定されている
- [ ] 対象言語が正しく選択されている
高度な活用方法¶
感情認識による自動表情変更¶
設定例:
起動フレーズ: 嬉しい|楽しい|ありがとう
Key Action: 笑顔
結果: 嬉しい発言時に自動で笑顔になる
配信シーン切り替え¶
設定例:
起動フレーズ: ゲーム開始|プレイ開始
Key Action: ゲーム画面
結果: ゲーム開始発言で画面レイアウト変更
多言語配信サポート¶
設定例:
表示内容: 翻訳1（英語）
結果: 日本語で話した内容が英語字幕で表示される