CloudflareのRealtime WebSocketアダプタが自動再接続とWebRTCメディアのバッファリングを行うようになりました

公開日: 2026-05-29

概要

Cloudflare Realtime SFUは、Cloudflareのグローバルネットワーク上で動作するWebRTC Selective Forwarding Unit（SFU）で、SFUインフラやリージョンを管理することなく、WebRTCクライアント間でライブ音声、ビデオ、データをルーティングできます。

今回、WebRTCメディアをWebSocketエンドポイントへストリームするために使用されるWebSocket adapterが、短時間のエンドポイント切断や再起動後に自動で再接続し、音声およびビデオをバッファするようになりました。

WebSocketエンドポイントへのWebRTCメディアのストリーミング

多くのチームは、Realtime SFUをバックエンドアプリケーションのメディア層（transcription、recording、note-taking、エージェント型メディア処理サービスなど）として利用しています。これらのシステムは、Durable Objects、Workers、Containers、または外部サービス上のバックエンドインフラで、SFUからのライブWebRTC音声やビデオを自分でWebRTCクライアントを実行せずに消費する必要があることが多いです。

WebSocket adapterはこのギャップを埋め、SFUから標準的なWebSocketエンドポイントへアプリケーションで扱えるペイロード（PCM audio framesやJPEG video frames）としてWebRTCメディアをストリームします。

変更点

• Stream mode (egress)でSFUから自分のWebSocketエンドポイントへライブ音声やビデオを送る場合、SFUが短時間のエンドポイント切断や再起動後に自動的に再接続するようになりました。
  • これは、録音、文字起こし、ライブ解析などの長時間稼働するメディアパイプラインで、WebSocketエンドポイントが短時間再起動する可能性がある場合に特に役立ちます。
• 以前は、WebSocketエンドポイントの短時間の切断によってアダプタが閉じられ、メディアが再開する前にアプリケーション側でアダプタを再作成する必要がありました。
• 現在はAPIの変更なしに、SFUが同じエンドポイントへ最大5秒間リトライします。エンドポイントがそのウィンドウ内に復帰すれば、音声とビデオの配信は自動的に再開します。
• 再接続の挙動には live-first media buffering（ライブファーストメディアバッファリング）も含まれており、短時間の中断でも古いビデオを再生せずにメディア損失を軽減します。

再接続時の挙動

• 音声: 可聴損失を低減するために短い有界バックログ（backlog）を使用します。中断がバックログでカバーできる時間を超えると、古い音声は破棄される可能性があります。
• ビデオ: 古いフレームを再生するのではなく、利用可能な最新のJPEGフレームから再開します。
• 回復はベストエフォートで行われ、ギャップレスやExactly-once deliveryを保証するものではありません。
• エンドポイントが5秒の再接続ウィンドウを超えて利用不可のままの場合、アダプタはクローズされ、再作成が必要です。

補足 / 参考

• WebSocket adapter
• Automatic reconnection for streaming
• Get started with Realtime SFU
• Realtime SFU example architecture
• Realtime vs Regular SFUs
• Global SFU Network Visualization ↗

---

このアップデートにより、長時間稼働するメディアパイプラインにおける短時間のエンドポイント障害による中断が大幅に軽減されます。