The Adaptive Stream
Playback that survives the tunnel — quality dips, the stream never dies.
The incident
The lecture videos were fixed 1080p files. On the commute — the exact moment students watched — every tunnel and every weak cell killed playback dead. Support tickets said 'the video is broken.' The video was fine. The delivery model was from 2009.
Why the obvious approach fails
Serving a single video file makes bitrate a decision the server takes once and the network gets no vote on. Real connections fluctuate constantly, and a fixed-bitrate stream has exactly two states: playing and stalled. The player can't step down to survive a dip, because there's nothing to step down to. Adaptive streaming inverts this: the video exists in several qualities, cut into seconds-long segments, and the player chooses each next segment based on the bandwidth it's actually seeing. Quality becomes elastic; playback becomes continuous. Users forgive a soft picture. They don't forgive a spinner.
The standard
- Video ships as HLS (or DASH): 2–6 second segments in 4–5 quality variants, from low-bandwidth to full HD.
- The master manifest lets the player switch quality mid-stream, per segment, with no rebuffer on downshift.
- Audio continuity is protected first — on severe dips, picture degrades before sound stutters.
- Segments are CDN-delivered; origin serves manifests and misses, never the hot path.
- Playback health is measured: rebuffer ratio and average bitrate per network tier are tracked per release.
How Cortex validates it
At plan time
video features declare their ladder (variants, bitrates) and CDN strategy; single-file MP4 delivery for long-form content fails plan review.
At validation
assert: video_delivery == segmented(hls|dash)assert: bandwidth_drop(mid_stream) → quality_downshift && playback_continuousassert: rebuffer_ratio(4g_profile) < declared_budgetAssertion syntax is illustrative.
At review
the approver sees the fluctuating-network run: bandwidth throttled in waves, the player stepping down and up, zero stalls on the record.