Twitch / YouTube ライブ

概要

Context BroにはTwitchとYouTube Liveのプラットフォームアダプターが内蔵されており、チャットメッセージをリアルタイムで観察してバッチで設定されたエンドポイントに送信します。

アダプターがアクティブな場合、拡張機能バッジに 📡 が表示されます。

仕組み

1. Twitchチャンネルまたは YouTube ライブ/VODページに移動
2. アダプターが自動的にアクティブになり、チャットDOMの監視を開始
3. チャットメッセージがスライディングウィンドウで収集される
4. 30秒ごとにバッチがコンパイルされ、デフォルトエンドポイントに送信
5. ページを離れると、アダプターがクリーンアップ

チャットバッチペイロード

各バッチには正規化されたチャットメッセージが含まれます：

{
  "event_type": "live_stream",
  "platform": "twitch",
  "channel": "streamer_name",
  "title": "配信タイトル",
  "category": "Just Chatting",
  "viewers": 12345,
  "isLive": true,
  "totalMessages": 250,
  "sampledMessages": 100,
  "messages": [
    {
      "user": "viewer123",
      "message": "こんにちは！",
      "roles": ["subscriber"],
      "event": "chat"
    }
  ],
  "donations": 3,
  "memberships": 1,
  "timestamp": "2026-02-22T14:30:00Z"
}

優先度サンプリング

チャットが混雑している場合（バッチあたり100メッセージ超）、Context Broは優先度サンプリングを使用：

1. 課金メッセージ（投げ銭、bits、スーパーチャット）— 常に含む
2. モデレーターと配信者メッセージ — 常に含む
3. 一般メッセージ — 100メッセージ上限にランダムサンプリング

重要なイベントが失われないことを保証します。

Twitchアダプター

サポート：

• ネイティブTwitchチャット、7TV、FrankerFaceZ (FFZ) DOM バリアント
• チャットメッセージ、サブスクリプション、ギフトサブ、raid、bits
• モデレーター/VIP/配信者ロール検出
• 削除されたメッセージの検出

YouTubeアダプター

サポート：

• ライブチャットメッセージ（テキスト、有料、ステッカー、メンバーシップ、ギフト）
• スーパーチャットとスーパーステッカーの金額（複数通貨）
• 新メンバー、再サブスク、ギフトイベント
• VOD字幕/トランスクリプト追跡（5秒ポーリング間隔）

YouTubeトランスクリプト

VODページでは、YouTubeアダプターが字幕/トランスクリプトも追跡します：

{
  "event_type": "transcript",
  "platform": "youtube",
  "videoId": "dQw4w9WgXcQ",
  "title": "動画タイトル",
  "channel": "チャンネル名",
  "text": "トランスクリプトテキスト...",
  "currentTime": 125.5,
  "duration": 3600,
  "timestamp": "2026-02-22T14:30:00Z"
}

重複排除

スライディングウィンドウ重複排除（10秒ウィンドウ）により、DOM急速更新時の重複メッセージを防止。メッセージは platform-username-messagePrefix をキーとします。