Implement support for LL-HLS #EXT-X-PRELOAD-HINT part loading #3988
Description
Adding support for Hinted Part and Map Preloading could reduce LL-HLS latency by an additional part duration. This feature was left out of v1.0 because of timing and the complexity involved in dropping hinted parts in situations that still need to be cataloged and tested. We also lacked multiple MAP support which has not landed in v1.0.4.
Feature summary and resources:
- Parse
EXT-X-PRELOAD-HINTtags and attributes:- #EXT-X-PRELOAD-HINT:TYPE=MAP,URI=”init.mp4”preload init segments (usually followed by a discontinuity)
- #EXT-X-PRELOAD-HINT:TYPE=PART,URI=”part.m4s”
- with byterange (length known)
#EXT-X-PRELOAD-HINT:TYPE=PART,URI=”part.m4s”,BYTERANGE-START=0,BYTERANGE-LENGTH=4044 - with byterange chunk-transfer
#EXT-X-PRELOAD-HINT:TYPE=PART,URI=”part.m4s”,BYTERANGE-START=0
- Make preload-hint requests and handle the response
- request part files and hold result for part update (no byterange)
- request part byterange and hold result for part update (length known)
- stream part file, hold result for part update byte-range(s) is received in part-update (chunk-transfer)
- do not sample TTFB for blocked part-hint responses
- Handle part updates following preload-hint
a. If part update matches preload-hint request/response push update
b. If part update invalidates preload-hint drop request/response
https://developer.apple.com/wwdc20/10229
https://developer.apple.com/wwdc20/10232
Metadata
Metadata
Assignees
Type
Projects
Status
Milestone
Relationships
Participants
Activity
[-]Hinted Part and Map Preloading[/-][+]Implement support for LL-HLS #EXT-X-PRELOAD-HINT part loading[/+]streamthing commentedon Sep 22, 2021
We need this! When?
Qizot commentedon Aug 8, 2022
Any update on this?
robwalch commentedon Sep 30, 2023
Waiting on the author to file the PR: master...feature/preload-hint
The feature is scheduled for a later release (Roadmap #5194) but can be released earlier with review and testing.
vk342 commentedon May 28, 2024
I have run the code in this PR against a proprietary low-latency live stream, and I am happy to report that my LL stream ran well.
While this PR did not resolve the stalling issues I reported in #6350, I did not observe any additional errors or latency.
I can confirm that download of PRELOAD-HINT part begins as soon as the new manifest is fetched and also, quite importantly, a bug in my encoder that could potentially affect LL playback did not have a negative effect on the hls.js performance:
For example, my encoder would generate this playlist:
but the next time manifest is updated, the encoder would return
The problem here is that for the first playlist the PRELOAD-HINT for
media-u07v181yd_b837632_vo_sfm4s_286023578.0_m3u8.cmfvwas mis-attributed to fragment286023577, while in fact it was the first part for then next fragment286023578.hls.js handles this case correctly: it just discards cashed data for
media-u07v181yd_b837632_vo_sfm4s_286023578.0_m3u8.cmfvwithout trying to append it to fragment286023577.When the same part is advertised as a part for fragment
286023578, hls.js tries to download it again, but, helpfully, it is already in the local browser cache.Many thanks to @iamboorrito for the robust code!