Controlling Video Quality
HLS players, by default will fetch the lowest quality before fetching higher quality. If you know your customers have higher bandwdith, or you’d like to serve more premium content, we give some configuration.
You can choose to set a minimum quality for a given video with these URL parameters:
| URL Parameter Key | URL Parameter Value |
|---|---|
| min-quality | ld sd hd 4k |
| max-quality | ld sd hd 4k |
| start-quality | ld sd hd 4k |
With the corresponding parameter name meaning these “short edge” resolutions
| Value | Resolution |
|---|---|
ld | 480p |
sd | 720p |
hd | 1080p |
4k | 2160p |
So, this URL will play a video starting with hd, but can drop down to sd if needed:
[...truncated]/master.m3u8?min-quality=sd&max-quality=hd&start-quality=hd
Full URL
https://worker.hesedvid.com/v1/edge_EVNENCJS37003VO58NNFZQTMWG7S66YA9TUY78/master.m3u8?min-quality=sd&max-quality=hd&start-quality=hdMore Examples
Only allow low definition playback:[...truncated]/master.m3u8?max-quality=ld
Only allow high definition playback (HD or 4k):
[...truncated]/master.m3u8?min-quality=hd
Start with sd (recommended for strong-bandwidth audiences):
[...truncated]/master.m3u8?start-quality=sd
Controlling Quality With Edge IDs Automatically
Edge IDs allow you to set defaults for playback quality. Create your Edge IDs and pass through arguments for min-quality, max-quality or start-quality to handle this automatically.
So, for example if you want to offer lower-tier subscribers hd and higher tier subscribers 4k, the best pattern would be to create two Edge IDs. One with a cap on quality, and one without a cap.
Caution
If you set min-quality, max-quality or start-quality to your Edge ID, you cannot override it with your URL parameters.