How versatica/mediasoup works
mediasoup is a low-level Selective Forwarding Unit (SFU), exposed as Node.js and Rust server APIs with a C++ media worker. The principal workflow is for an application to create a worker and router, establish transports, publish media or data, then create consumers to forward selected streams to endpoints. The README also documents plain RTP, simulcast/SVC, congestion control, and audio-level/active-speaker capabilities. Paths and domain responsibilities are grounded in the tree; unsampled subsystem wiring is shown only where documented, so some internal call links are omitted.
Main entry points: Transport.ts Transports · Router.ts Router · Worker.ts Node Worker · main.cpp Worker Runtime
Components 22
Server APIs
- Node API
node/src/index.ts - Rust API
rust/src/lib.rs - Worker Manager
rust/src/worker_manager.rs - Node Worker
node/src/Worker.ts
Routing and Media
- Router
node/src/Router.ts - Transports
node/src/Transport.ts - WebRTC Transport
node/src/WebRtcTransport.ts - Plain RTP
node/src/PlainTransport.ts - Producer
node/src/Producer.ts - Consumer
node/src/Consumer.ts - Data Producer
node/src/DataProducer.ts - Data Consumer
node/src/DataConsumer.ts - RTP Observers
node/src/RtpObserver.ts - RTP Capabilities
node/src/ortc.ts
Media Worker
- Worker Runtime
worker/src/main.cpp - Port Manager
worker/src/RTC/PortManager.cpp - Stream Manager
worker/src/RTC/SimulcastProducerStreamManager.cpp
Network and Adaptation
- Send Controller
worker/deps/libwebrtc/libwebrtc/call/rtp_transport_controller_send.cc - Loss Estimator
worker/src/RTC/BWE/LossBasedController.cpp - Probe Controller
worker/src/RTC/BWE/ProbeController.cpp
Other components
- Application
- WebRTC / RTP Endpoint
Connections 23
- Application → Node API: uses
- Application → Rust API: uses
- Node API → Node Worker: creates
- Rust API → Worker Manager: creates workers
- Node Worker → Worker Runtime: starts worker
- Node Worker → Router: creates router
- Router → Transports: creates transports
- Transports → WebRTC Transport: specializes
- Transports → Plain RTP: specializes
- Router → RTP Capabilities: uses capabilities
- Transports → Producer: publishes media
- Transports → Consumer: forwards media
- Transports → Data Producer: publishes data
- Transports → Data Consumer: forwards data
- Router → RTP Observers: creates observers
- Worker Runtime → Port Manager: binds ports
- Worker Runtime → Stream Manager: processes streams
- Stream Manager → Send Controller: adapts layers
- Send Controller → Loss Estimator: estimates bitrate
- Send Controller → Probe Controller: requests probes
- WebRTC Transport → WebRTC / RTP Endpoint: exchanges media
- Plain RTP → WebRTC / RTP Endpoint: exchanges RTP
- Data Consumer → WebRTC / RTP Endpoint: sends data