Skip to content

v1.5.0-beta.1

Pre-release
Pre-release
Compare
Choose a tag to compare
@github-actions github-actions released this 05 Dec 18:56
· 1111 commits to master since this release
v1.5.0-beta.1
fad22f2
This commit was created on github.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

Summary

HLS.js v1.5.0-beta.1 includes playback and API enhancements targeted at supporting HLS assets containing HDR video variants and multi-channel audio renditions.

Changes Since v1.5.0-alpha.1

v1.5.0-alpha.1...v1.5.0-beta.1

  • API enhancements for audio and subtitle selection (#5978) @robwalch
  • HDR/SDR VIDEO-RANGE selection and priority (#6007)
  • Expand isSupported check to allow alternative codecs (#6006)
  • Use named exports in ESM output (#5930)
  • Fixed issues parsing sei_messages (#5998) @jcekstrom
  • Fixed issues with long cea608 captions (#5953) @jcekstrom
  • Fixed regression in dev with CEA608 parser setup (#5986) @robwalch
  • Refactor CMCD controller and tests to use the common media library utilities (#5903) @littlespex
  • Use Content Steering Pathways to manage Redundant Streams (#5970) @robwalch
  • Fixed detach attach behavior dropping one of two SourceBuffers (#5974)
  • Remove the use of self from enableLogger (#5936)
  • Check ManagedMediaSource removedRanges length on "bufferedchange" event (#5915)
  • Upgrade to Rollup 4 (#5886) @tjenkinson
  • Configure typescript, eslint, and prettier caches (#5990)
  • Update karma-rollup-preprocessor to the version that works in watch mode (#5991)

Changes Since The Last Release (v1.4.12)

v1.4.12...v1.5.0-beta.1

API Enhancements

  • Named exports for all classes and enums are available in ESM output (#5930)
  • Rendition selection enhancements (#5704)
    • HLS.js will no longer start on the first variant (hls.firstLevel), or any variant of a preferred codec, if its BANDWIDTH exceeds abrEwmaDefaultEstimateMax.
    • Added hls.firstAutoLevel getter, used internally to get the starting level index.
      hls.levels are sorted on height, frame rate, preferred codec, and video-range to infer order by quality. Height-first sorting allows cap-level-lontroller to set a max quality index at the maximum allowed resolution.
    • Added getters for all audio tracks and all subtitle tracks: hls.allAudioTracks and hls.allSubtitleTracks
  • API enhancements for audio and subtitle selection (#5978)
    • hls.setAudioOption() and config.audioPreference have been added to simplify audio selection based on user preferences and playback settings
    • hls.setSubtitleOption() and config.subtitlePreference have been added to simplify subtitle selection based on user preferences and playback settings. Only subtitle media options (hls.allSubtitleTracks) are subject to selection criteria. Captions are either assigned a TextTrack or emitted through events when native rendering is disabled.
  • config.videoPreference.preferHDR and preferHDR have been added to override the default SDR/HDR selection behavior
  • Base initial bandwidth estimate on first level bitrate #5649
    • Added setter for bandwidthEstimate that resets estimator to new starting value
  • Initial selection and level filtering based on preferred codecs and MediaCapabilities #5704
    • Added config.useMediaCapabilities (defaults to true)
    • Set config.useMediaCapabilities to false to disable the use of MediaCapabilities.decodingInfo
  • isSupported() has been expanded to test alternate baseline codecs (#6006)
    • Added isMSESupported(), a subroutine of isSupported(), checks for MediaSource API without isTypeSupported checks.
    • Added getMediaSource() which returns the preferred MSE interface or undefined when unavailable
    • Added named exports for isSupported, isMSESupported, and getMediaSource
  • Fire STEERING_MANIFEST_LOADED event when loading a Content Steering Manifest (#5417) @guillemcabrera
  • Added config flag for maximum front buffer frontBufferFlushThreshold (#5761) @iamboorrito
  • Implement event for maxAutoLevel change #5763
  • Specify custom shouldRetry predicate in retryConfig (#5658) @PavelFomin90 (completed in #5762)
  • Default estimate enhancements #5649
    • Added config.abrEwmaDefaultEstimateMax option which limits how high default value can be adjusted to.
      Separate peak and average bitrates of Level objects
  • Level properties
    • Level.bitrate uses variant BANDWIDTH (required peak bitrate) before falling back to optional AVERAGE-BANDWIDTH.
    • Level.averageBitrate returns parsed AVERAGE-BANDWIDTH. Falls back to runtime average Level.realBitrate (which is only set when config.abrMaxWithRealBitrate is enabled) and finally Level.bitrate (BANDWIDTH).
    • Added Level.frameRate returns parsed FRAME-RATE number or 0.
    • Added Level.codecs returns parsed CODECS or emptry string.
    • Added Level.score returns parsed SCORE number or 0.

Codec Support

iOS 17.1 Support

Live Streaming Bug Fixes

  • Fixed Low-Latency HLS directives skipping part 0 @jhonalino in #5714
  • Fixed support of skip directive without block reload (#5791) @robwalch
  • Fixed live frag finding after detach and re-attach past live window (#5742)
  • Handle #EXT-X-ENDLIST appended to live playlist without new segment (#5778)

Captions, Subtitles, and Metadata Bug Fixes

  • Clear CEA-608 captions on discontinuity (#5557)
  • Fixed DateRange metadata cue duration with ID3 cues that overlap (#5546)
  • Use input timescale when remuxing inband captions (#5675)

Bug Fixes (Misc)

  • Filter variants with any unsupported codecs (#5533) @robwalch
  • Fixed two AV1 parsing issues (#5774) @nyanmisaka
  • Push AUD units to fix decode errors with some TS segments (#5696) @robwalch
  • Fail MP3 probe if AC3 or EC3 detected (#5695)
  • Prevent ADTS probe false positives when bytes following ID3 are a match for MPEG audio (#5783)
  • Reset init segment when M2TS video configuration changes (#5794)
  • Fixed capLevelToPlayerSize after hiding player and maintain stable selection when aspect ratio changes (#5614)
  • Fixed handling of segments at the discontinuities that do not start with a keyframe (#5659)
  • Fixed AC3 PES parsing (#5673) @softworkz
  • Fixed issue #5632, where missing AUD units for keyframes causes them to be merged with their preceding frame (#5652) @Thulinma
  • Fixed Safari decode errors with DTS not increasing when PTS decreases (#5710) @robwalch
  • Fixed PlayReady DRM in Edge browser (#5699) @mikrohard
  • Do not jump start gaps when paused (#5502) @robwalch
  • Never back-track on first fragment to avoid loop loading (#5613)
  • Use last discontinuity bounds when aligning playlists on PDT (#5681)
  • Load last alt-audio segment even when is starts after the end of the main playlist (#5717)
  • Do not exit from stall detection when playhead is at or past end of buffer (#5779)
  • Error and switch on SourceBuffer append requests for non-existing tracks (#5485)
  • Handle mixed sourcebuffer errors (#5623)
  • Remove SourceBuffers on "updateend" when MediaSource is closed (#5731)
  • Resume fragment loading after level switch follows level error (#5537)
  • Prevent recursion in error event handlers that throw (#5549)
  • Reset loading start on worker setup error (#5620)

Minor Enhancements

  • Lazy init CEA608 parsers (#5689) @robwalch
  • Improve buffer-controller logging (#5548)
  • Do not modify fmp4 bytes when there is no offset (#5780)

Typescript Improvements

  • Correcting usage of extended generic type LoaderContext in type Loader (#5494) @lvnam96
  • Make loader context nullable and cleanup loader cleanup (#5552) @robwalch

Demo Page Enhancements

Documentation

  • Added additional documentation for workerPath config (#5765) @mogzol

Project and CI

  • Upgrade to Rollup 4 (#5886) @tjenkinson
  • Configure typescript, eslint and prettier caches (#5990)
  • Update karma-rollup-preprocessor to version that works in watch mode (#5991)
  • Update question.yaml template description (#5591) @robwalch
  • Added Visual Studio Exclusions to .gitignore (#5635) @softworkz

Demo Page

https://c2e375b8.hls-js-dev.pages.dev/demo/

Feedback

Please provide feedback via Issues in GitHub. For more details on how to contribute to HLS.js, see our CONTRIBUTING guide.

Contributors

mikrohard, jcekstrom, and 16 other contributors
Assets 3
Loading