release/v3.24.0

[peaBerberian]

Status: Everything is ready, only thing left is testing.

For now scheduled for 2021-04-01 (but could be sooner or later).

Changelog

Features

• Add inbandEvent event for when an event is encountered in a media segment [Add EMSG support #892]
• DRM: Add singleLicensePer keySystems option to be able to signal in advance that the current content has a single license, even if it has multiple encryption keys [Multiple keys per license implementation #863, Single license per content implementation #904]
• DRM: Add keySystems[].licenseStorage.disableRetroCompatibility boolean to unlock optimizations when compatibility with EME sessions persisted in older RxPlayer versions is not important [Only use concerned encryption systemId when found in the Manifest #919]

Bug fixes

• DASH: Fix rounding error that could cause infinite buffering issues when going from a DASH Period to the next [Javascript rounding errors can produce unwanted behaviors in RxPlayer #897, Take into account rounding errors for indexes computing and comparisons #899]
• DRM: Always pass on server certificate before any challenge is generated. Contents with multiple licenses previously could lead to the latter being done before the former. [drm: perform setServerCertificate before init data has been received #895]
• DRM: Fix possible leaks of MediaKeySessions if closed at the wrong time [EME: Fix possible leaks of MediaKeySessions if closed at the wrong time #920]
• Fix issue making sudden and acute fall in bandwidth not being considered soon enough [Fixes on handling sudden fall in bandwidth #906]
• On some devices when maxBufferAhead is set, avoid removing the initially loaded data if done before the initial seek could be performed [Add the clock's wantedTimeOffest to the BufferGarbageCollector's #907]
• Avoid cases of infinite rebuffering on Tizen 4 by avoiding pushing segments "on top of others" too close to the current position [generalize segment paddings to all devices #925]
• Avoid seeking issues on Tizen by not seeking over discontinuities that will be already handled by the browser [Avoid seeking over discontinuities when the browser seeks back #922]
• Fix initial seek on Tizen (Samsung TVs) on live contents by setting a much lower duration (to work-around a Tizen overflow) [set a much lower duration by default for live contents #914]
• DASH: Consider multiple defined <Accessibility> tags for a single AdaptationSet [Consider multiple accessibility descriptors #903]
• Fix error that could be thrown on Safari when calling the getStatusForHDCP method from the experimental MediaCapabilitiesProber tool [DetectionHDCP can break cause of a miss interpreted error handling #927]

Other improvements

• Avoid to push on top of the current position if there's already a segment there as it can provoke minor decoding issues on some devices [generalize segment paddings to all devices #925]
• Update video element's duration if the content duration changes [Feat/update mediasource duration #917]
• DASH: Improve loading time with encrypted contents by only using the encrypted initialization data found in the Manifest when found in it [Only use concerned encryption systemId when found in the Manifest #919]
• Record redirections made on a manifestUpdateUrl to request directly the right URL on next update. [Update manifest update URL at manifest partial refresh #929]
• Improve loading time when a serverCertificate is given by calling the setServerCertificate API earlier [drm: perform setServerCertificate before init data has been received #895]
• Improve loading time when switching contents by fetching the Manifest at the same time the previous content is cleaned-up [improve content switching performance by loading the Manifest ASAP #894]
• Improve loading time on some CPU-constrained devices by not running unnecessary playback checks on the "progress" HTMLMediaElement event anymore [Remove "progress" event from being listened by the clock #893]
• DASH: Consider DASH audio AdaptationSet with a "urn:mpeg:dash:role:2011" schemeIdUri and a "description" role as audioDescription tracks [Consider multiple accessibility descriptors #903]
• Warn through the logger when the autoplay attribute is enabled on the media element but not on RxPlayer [[Proposal] Warn user when autoplay is enabled on the media element but not on RxPlayer #924]
• Avoid switching to a SEEKING state if the seek operation was performed inside the RxPlayer's code [[Proposal] Hide media operation coming from the RxPlayer internals from the API #872, Feat/identify seek from inside #887]
• DRM: Wait up to 100 milliseconds after a persistent MediaKeySession has been loaded to wait for possibly late keyStatuses updates [eme: wait at most 100ms after a session is loaded to check on its keyStatuses #928]
• DRM: Only store persistent MediaKeySession once at least one key is known [ eme: only persist MediaKeySessions once its keys are known  #926]
• DRM: Reconsider Representations that have been fallbacked from if they become decipherable [Mark decipherable Representations as decipherable even if they were undecipherable before #905]
• Doc: Move architecture documentation closer to the code it documents [[Proposal] Move architecture documentation closer to the code #764, doc: move architecture documentation files closer to the code #900]
• Doc: add "Quick links" to the top of the API documentation [add quick links inside the RxPlayer API Page #909]