Browse Source

Expand on bitrate switching documentation

Move bitrate switching docs out of the readme. Add some pretty graphics.
pull/230/head
David LaPalomento 11 years ago
parent
commit
81b75b3ee5
  1. BIN
      docs/bitrate-switching-1.graffle
  2. BIN
      docs/bitrate-switching-1.png
  3. BIN
      docs/bitrate-switching-2.graffle
  4. BIN
      docs/bitrate-switching-2.png
  5. BIN
      docs/bitrate-switching-3.graffle
  6. BIN
      docs/bitrate-switching-3.png
  7. BIN
      docs/bitrate-switching-4.graffle
  8. BIN
      docs/bitrate-switching-4.png
  9. 40
      docs/bitrate-switching.md

BIN
docs/bitrate-switching-1.graffle

BIN
docs/bitrate-switching-1.png

After

Width: 683  |  Height: 518  |  Size: 29 KiB

BIN
docs/bitrate-switching-2.graffle

BIN
docs/bitrate-switching-2.png

After

Width: 683  |  Height: 518  |  Size: 35 KiB

BIN
docs/bitrate-switching-3.graffle

BIN
docs/bitrate-switching-3.png

After

Width: 683  |  Height: 518  |  Size: 41 KiB

BIN
docs/bitrate-switching-4.graffle

BIN
docs/bitrate-switching-4.png

After

Width: 761  |  Height: 518  |  Size: 38 KiB

40
docs/bitrate-switching.md

@ -0,0 +1,40 @@
# Adaptive Switching Behavior
The HLS tech tries to ensure the highest-quality viewing experience
possible, given the available bandwidth and encodings. This doesn't
always mean using the highest-bitrate rendition available-- if the player
is 300px by 150px, it would be a big waste of bandwidth to download a 4k
stream. By default, the player attempts to load the highest-bitrate
variant that is less than the most recently detected segment bandwidth,
with one condition: if there are multiple variants with dimensions greater
than the current player size, it will only switch up one size greater
than the current player size.
If you're the visual type, the whole process is illustrated
below. Whenever a new segment is downloaded, we calculate the download
bitrate based on the size of the segment and the time it took to
download:
![New bitrate info is available](bitrate-switching-1.png)
First, we filter out all the renditions that have a higher bitrate
than the new measurement:
![Bitrate filtering](bitrate-switching-2.png)
Then we get rid of any renditions that are bigger than the current
player dimensions:
![Resolution filtering](bitrate-switching-3.png)
We don't want to signficant quality drop just because your player is
one pixel too small, so we add back in the next highest
resolution. The highest bitrate rendition that remains is the one that
gets used:
![Final selection](bitrate-switching-4.png)
If you'd like your player to use a different set of priorities, it's
possible to completely replace the rendition selection logic. For
instance, you could always choose the most appropriate rendition by
resolution, even though this might mean more stalls during playback.
See the documentation on `player.hls.selectPlaylist` for more details.
Loading…
Cancel
Save