Cross-reference

JSEP (incl. Plan B/Unified Plan & ORTC)

Where it enters the lineage

This concept is first developed in § m4-l1 — The Plugin Decade and the $68M Bet. The historical problem there matters: WebRTC components are not arbitrary layers; each is a repair for a specific limit in the system before it.

1What it is

RFC 8829's philosophy — the browser does media, you do signaling — its signaling state machine and rollback, and the standards fights (Plan B vs Unified Plan, the ORTC rebellion) fossilized in the API.

JSEP exposes offer/answer and state transitions to JavaScript while the browser owns the media engine. Rollback and stable transceiver-to-m-line mapping are central to surviving concurrent negotiation.

2How to reason about it

The operational claim is precise: RFC 8829's philosophy — the browser does media, you do signaling — its signaling state machine and rollback, and the standards fights (Plan B vs Unified Plan, the ORTC rebellion) fossilized in the API. Treat it as an observable contract. Record the state transition or counter that proves it, test the failure path as well as the happy path, and keep units and clock domains explicit. That discipline is what separates a plausible WebRTC explanation from a production diagnosis.

Separate the control plane from the data plane, then name the clock, identifier, and unit attached to each observation. Ask what is negotiated, what is measured live, and what is merely configured. A robust explanation predicts both a successful trace and the characteristic failure trace.

inputstate · packet · frameJSEP (incl. Plan B/Unimechanismprooftrace
Concept plate — Follow the mechanism to an observation that can falsify your model.

3Its role in WebRTC

In an application, this concept does not stand alone. It participates in a chain of negotiation, transport, media processing, and feedback. The practical boundary is the API, SDP attribute, RTP/RTCP field, or stats record where the browser exposes it. Use that boundary in tests: feed controlled input, observe the named output, and verify fallback behavior when the preferred path is unavailable.

A useful study method is to draw three columns: configured, negotiated, and observed. Put application preferences and constraints in the first, the answer's accepted parameters in the second, and live packet, state, or stats evidence in the third. Disagreements between columns are diagnostic information. They reveal fallback, unsupported capability, stale state, or a mistaken assumption about which endpoint controls the behavior. This method scales from a single codec preference to an ICE restart or a multi-layer SFU route.

Diagnostic discipline

Do not infer success from configuration alone. A codec in capabilities is not necessarily negotiated; a candidate in SDP is not necessarily selected; a connected peer connection is not necessarily receiving decodable frames. Prefer the narrowest live evidence.

4Failure questions

QuestionEvidence
Was it negotiated or selected?Inspect the answer and the live stats graph.
Did the state transition complete?Record ordered events with timestamps.
Are counters moving in the expected direction?Compute deltas; never compare unrelated cumulative samples.
What happens beyond the latency or capacity budget?Inject delay, loss, reordering, or constrained bandwidth.

5Related concepts

  • ICE (incl. Trickle & mDNS) — The complete RFC 8445 machine: candidates, priorities, checklists, roles, nomination — plus Trickle ICE, mDNS privacy candidates, consent freshness, and ICE restarts.
  • DTLS-SRTP — Mandatory media encryption: the DTLS handshake on the media path, fingerprint binding through SDP, SRTP key export and cipher suites — and the SDES plaintext-key flaw it replaced.
  • Media Topologies: Mesh, MCU, SFU — The three fan-out architectures and their bandwidth/CPU/latency/E2EE tradeoff matrix — why mesh dies at four, why MCUs transcode, and why route-don't-decode won.
  • Opus — RFC 6716, the audio war's peace treaty: SILK+CELT hybrid design, modes and frame sizes, DTX, in-band FEC and PLC, and the fmtp knobs that tune it. Also carries the perceptual-coding foundation from m5-l1 — masking, critical bands, LPC/CELP lineage, rate-distortion intuition — cross-linked as the basis of everything Opus does.

6Further reading

WebRTC: From First Principles · Concept reference