Skip to main content

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 KeyURL Parameter Value
min-qualityld sd hd 4k
max-qualityld sd hd 4k
start-qualityld sd hd 4k

With the corresponding parameter name meaning these “short edge” resolutions

ValueResolution
ld480p
sd720p
hd1080p
4k2160p

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 URLhttps://worker.hesedvid.com/v1/edge_EVNENCJS37003VO58NNFZQTMWG7S66YA9TUY78/master.m3u8?min-quality=sd&max-quality=hd&start-quality=hd

More ExamplesOnly 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.