SDP: Session Description Protocol
Learn how SDP describes the media format, codec, and network information exchanged between peers to negotiate a connection.
SDP: Session Description Protocol is a free Real-Time Streaming Systems (WebRTC + Live Data) lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Real-Time Streaming Systems (WebRTC + Live Data) learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
What is SDP?
SDP stands for Session Description Protocol. It's a text-based format used in WebRTC to describe the capabilities and parameters of a media session.
Think of it as a blueprint for what kind of audio, video, and data a peer wants to send or receive, and how it can be reached.
SDP's Role in WebRTC
Before two WebRTC peers can send data directly, they need to agree on many things:
- What media types (audio, video, data) they support.
- Which codecs to use (e.g., Opus for audio, VP8 for video).
- Their network addresses and connection methods.
SDP is the standard way to exchange this crucial information.
SDP in Offer/Answer
WebRTC uses an "Offer/Answer" model for negotiation. One peer creates an SDP Offer, describing its capabilities. The other peer receives it and creates an SDP Answer, indicating its own capabilities and agreement.
This exchange happens via a signaling server, which we discussed in the previous lesson.
SDP Message Structure
An SDP message is a collection of lines, each starting with a single lowercase letter followed by an equals sign (=). These lines are grouped into a session description and one or more media descriptions.
Common lines include: v=, o=, s=, t=, c=, m=, and a=.
SDP: Version & Origin
Every SDP message begins with a version line and an origin line:
v=0: Specifies the SDP protocol version. Always 0 for WebRTC.o=: Describes the session's originator and identifier.IN IP4
The <sess-id> and <sess-version> are unique numbers, and <address> is typically 127.0.0.1 for local generation.
SDP: Session Name & Time
Next, we find the session name and time description:
s=-: The session name. Often just a hyphen for WebRTC.t=0 0: The session's active time.0 0means permanent/always active for WebRTC.
These lines provide basic context for the overall session.
SDP: Connection Data
The c= line provides connection data, specifically the IP address for the session. In WebRTC, this is often set to 0.0.0.0 or 127.0.0.1 as the actual peer-to-peer connection addresses are negotiated later via ICE candidates.
Example: c=IN IP4 0.0.0.0
SDP: Media Descriptions (`m=`)
The m= line is critical! It describes a specific media stream (audio, video, or data channel). An SDP can have multiple m= lines.
Format: m=
<media>:audio,video, orapplication(for data channels).<port>: The port number (often 9 for WebRTC, actual port from ICE).<protocol>: E.g.,UDP/TLS/RTP/SAVPF.<fmt list>: A list of supported payload types/codecs.
SDP: Attributes (`a=`)
a= lines provide additional attributes for the session or a specific media stream. They are highly flexible and carry a lot of WebRTC-specific information.
a=rtpmap:: Maps payload types to codecs./ a=fingerprint:...: TLS certificate fingerprint.a=sendrecv,a=sendonly,a=recvonly: Directionality of media.a=ice-ufrag,a=ice-pwd: Used for ICE connectivity checks.
See a Simplified SDP
Here's a simplified example of what an SDP offer might look like. Notice the different lines and their roles in describing the session and media capabilities.
Try running it to see the raw SDP text!
function main() {
const sdpExample = `v=0
o=- 3749449080 3749449080 IN IP4 127.0.0.1
s=-
t=0 0
c=IN IP4 0.0.0.0
m=audio 9 UDP/TLS/RTP/SAVPF 111
a=rtpmap:111 opus/48000/2
a=mid:audio
a=sendrecv
a=ice-ufrag:abcdefg
a=ice-pwd:hijklmn
a=fingerprint:sha-256 A1:B2:C3:D4:E5:F6:A7:B8:C9:D0:E1:F2:A3:B4:C5:D6:E7:F8:A9:B0:C1:D2:E3:F4:A5:B6:C7:D8
`;
console.log("Simplified SDP Offer:");
console.log(sdpExample);
}
main();Quick Check on SDP
Which SDP line primarily describes the type of media (audio, video, or data), its associated port, transport protocol, and supported formats?
Recap: SDP Essentials
Great job! You've learned about SDP, the Session Description Protocol, which is fundamental to WebRTC.
- SDP is a text format for describing media and network capabilities.
- It's used in the Offer/Answer model to negotiate connections.
- Key lines include
v=,o=,s=,t=,c=,m=, anda=. - The
m=line describes media, anda=lines provide rich attributes.
Next, we'll dive into ICE candidates, which help peers find the best network path!
Frequently asked questions
Is the “SDP: Session Description Protocol” lesson free?
Yes — the full text of “SDP: Session Description Protocol” is free to read here on the web, and the Real-Time Streaming Systems (WebRTC + Live Data) course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Real-Time Streaming Systems (WebRTC + Live Data) course, upgrade to CoddyKit PRO.
What will I learn in “SDP: Session Description Protocol”?
Learn how SDP describes the media format, codec, and network information exchanged between peers to negotiate a connection. You practise Real-Time Streaming Systems (WebRTC + Live Data) with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Real-Time Streaming Systems (WebRTC + Live Data)?
No prior experience is required. Real-Time Streaming Systems (WebRTC + Live Data) on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “SDP: Session Description Protocol” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Real-Time Streaming Systems (WebRTC + Live Data) lesson?
Yes. Every Real-Time Streaming Systems (WebRTC + Live Data) lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- The Role of Signaling Servers
- SDP: Session Description Protocol
- ICE Candidates and Connectivity
- Renegotiation and Connection State