AITuber開発日誌 3 VTube Studioの連携「体」を作る!

VTube Studioとの通信には「WebSocket（ウェブソケット）」という仕組みを使います。そのためのライブラリをインストールします。

PowerShell（ターミナル）で以下を実行してください：

pip install websockets

「許可証（トークン）」を発行してもらうための、1回だけ使う専用プログラムを作成します。

• ファイル名: setup_vts.py （ルートディレクトリに作成）

以下のコードをコピーして貼り付けてください。

import asyncio
import websockets
import json
import os

# 設定
VTS_URL = "ws://localhost:8001"
PLUGIN_NAME = "MyAITuber"  # 好きな名前に変更可
DEVELOPER_NAME = "MyName"  # あなたの名前に変更可

async def authenticate():
    print(f"🔌 VTube Studio ({VTS_URL}) に接続中...")
    
    try:
        async with websockets.connect(VTS_URL) as websocket:
            print("✅ 接続成功！")
            print("⏳ VTube Studioの画面を見てください。「許可」を求めるポップアップが出ます。")
            
            # 1. 認証トークンをリクエストする
            request = {
                "apiName": "VTubeStudioPublicAPI",
                "apiVersion": "1.0",
                "requestID": "TokenRequestID",
                "messageType": "AuthenticationTokenRequest",
                "data": {
                    "pluginName": PLUGIN_NAME,
                    "pluginDeveloper": DEVELOPER_NAME,
                }
            }
            
            await websocket.send(json.dumps(request))
            
            # 2. レスポンスを待つ（VTS側で「許可」が押されるまで待機）
            response = await websocket.recv()
            data = json.loads(response)
            
            # 3. 結果の確認
            if "data" in data and "authenticationToken" in data["data"]:
                token = data["data"]["authenticationToken"]
                print("\n" + "="*50)
                print("🎉 トークン取得に成功しました！")
                print("以下のトークンを .env ファイルの VTUBE_STUDIO_API_TOKEN に貼り付けてください：")
                print("-" * 50)
                print(token)
                print("-" * 50)
                print("="*50 + "\n")
            else:
                print("❌ 失敗しました。VTube Studio側で「拒否」されたか、エラーが発生しました。")
                print(f"レスポンス: {data}")

    except ConnectionRefusedError:
        print("❌ エラー: VTube Studioに接続できませんでした。")
        print("ヒント: VTube Studioは起動していますか？ 設定で「APIの起動」はONになっていますか？")

if __name__ == "__main__":
    asyncio.run(authenticate())

重要：実行前に必ず VTube Studio アプリを起動しておいてください。

python setup_vts.py

表示されたトークンをコピーして、.env ファイルの VTUBE_STUDIO_API_TOKEN= の後ろに貼り付けて保存してください。