@castlabs/prestoplay 6.2.8 → 6.4.0

package/CHANGELOG.md

@@ -1,8 +1,88 @@
+# 6.4.0
+
+## New Features
+
+* Add track accessibility features to the public API for DASH streams (under `clpp.Track.accessibility`).
+* HTTP status codes that will not trigger the retry behaviour can now be configured.
+  Previously, status codes 401 and 403 were not triggering the retry behaviour. This is still
+  the default, but can be changed now in the [AttemptParameters](https://demo.castlabs.com/#/docs?q=clpp.net#AttemptParameters)
+  for requests types, and globally by adjusting `clpp.net.DEFAULT_FATAL_STATUS_CODES`. The
+  configuration is also forwarded to [clpp.net.Request](https://demo.castlabs.com/#/docs?q=clpp.net#Request)
+  and can be adjusted per request using a [RequestModifier](https://demo.castlabs.com/#/docs?q=clpp.net#RequestModifier).
+* Add support for Low-Latency HLS.
+  * Support for Partial Segments and Preload Hint.
+  * Support for Blocking Playlist Reload.
+  * Configuration by [Player configuration](https://demo.castlabs.com/#/docs/configuration) property `lowLatencyMode`, defaults to `false`.
+
+## Changes
+
+* Fix timeline of dynamic to static transition in DASH.
+* Several improvements of tracks.
+  * Fix an issue in DASH where similar `AdaptationSet` tags with distinct `Accessibility` tags where being
+  processed as renditions of the same track instead of being treated as two distinct tracks.
+  * Fix a corner-case issue where tracks with the same roles but in a different order were being treated as two
+  separate tracks instead of a single track with two different renditions.
+  * Fix issues with audio track selection when `preferredAudioRole` or `preferredAudioLanguage` is configured.
+* Warn when an unsupported version of `youboralib` is supplied to the `YouboraPlugin` and emit
+  a recoverable error. Supported versions are 6.8.12 - 6.8.25.
+* Fix support for custom styling of subtitles.
+* Fix `clpp.utils.obj.merge`.
+  * Make sure it merges attributes with values that are DOM `Element`.
+  * Fix documentation: `clpp.utils.obj.merge` merges from left to right, not the other way around.
+* Improve `clpp.PlayerSurface`.
+  * Add `clpp-video` class to the video/media element.
+  * Protect PRESTOplay class attributes from modification. This prevents unexpected
+    styling issues related to the re-rendering of the video or container element that can
+    easily occur when used with React, Vue or similar UI frameworks.
+* Improve validation of arguments passed to `clpp.Player`.
+* Fix an issue where special kinds of live streams such as IPR (in-progress recording)
+  were not correctly classified as live by `Player.isLive()`.
+* Fix error reporting for invalid or failing thumbnails (VTT, BIF).
+* Improved sync byte search for TS segment start time parsing
+* Update metadata `player_name` default of Mux Analytics to `CastLabsPlayer`
+* Fix time synchronization issues during sender/receiver switch for Smooth Streaming live streams on Chromecast.
+* Dedicated handling for Widevine server certificate requests. We are now logging
+  Widevine Server Certificate requests explicitly and set the `licenseRequestType` of
+  the `request` to 'certificate-request'.
+* Fixed issues with handling key restrictions in different multi period scenarios
+
+# 6.3.0
+
+## **Warning!**
+Changes in this release might cause breaking changes for some use cases. Please double-check your current usage of the following:
+* `player.getPresentationStartTime()` - For non-live content, this method now returns `null`, instead of the previous `0`.
+
+## Changes
+* Fix issues with `YouboraPlugin`.
+  * Fix crash when Youbora configuration is not passed via `clpp.Player` constructor.
+  * Fix an issue where Youbora plugin stopped reporting events after a call to `setYouboraPlugin`.
+  * Fix an issue with the import of `youboralib` and `@castlabs/prestoplay/cl.youbora`
+    when used with a bundler which performs hoisting of import statements (such as Webpack).
+* Improvements on FPS License management. This release includes several improvements
+  related to the FairPlay License management with the Apple Prefixed implementation
+  as well as the EME implementation. Handling of multiple license requests is
+  improved, and we added a few workarounds that allow us to handle rejected payloads
+  better and reduce the number of failed playback attempts which previously
+  caused 3016 decode errors.
+* Fixed an issue where the initials FPS license request with the EME implementation
+  was incorrectly reported as a renewal request.
+* Changed the behavior of `player.getPresentationStartTime()`. The method now only returns numerical values when the stream is
+  live and the calculation of presentation start time is possible; otherwise, it returns `null`. **Note: potentially breaking change!**
+* Chromecast Cast Web Sender & Web Receiver related changes:
+  * Fixed time synchronization issues for DASH live streams between cast sender and receiver. The updates address
+  problems related to seeking, switching between sender/receiver, and incorrect values returned from SDK during active casting.
+  * Fix `player.getDuration()` return value during live stream casting. The function now correctly returns `Infinity`,
+  addressing the previous bug where `-1` was incorrectly returned. This fix applies to both receiver and sender sides
+  during active casting.
+  * Changed the behavior of the `clpp.cast.CastProxy.setContentMetadata()` method. This method now also accepts null, which will clear the metadata.
+  * Added the `clpp.cast.CastProxy.getContentMetadata()` method.
+  * In an effort to simplify the `clpp.cast.CastProxy` metadata API, we are deprecating the following methods: `setContentTitle()`, `setContentImage()`, `setContentArtist()`, `setContentReleaseDate()`, `clearContentMetadata()`. These methods will still work, but they will be removed in the next release. Please use the `setContentMetadata()` method instead. Refer to the documentation for details.
+
 # 6.2.8
 
 ## Changes
 
-* Fix clock sync fallback in DASH. 
+* Fix clock sync fallback in DASH.
   * This fixes an issue where one failing `UTCTiming` tag
     cancelled the whole time sync. Now all `UTCTiming` tags are tried one-by-one until one
     succeeds, or if all fail, only then the time sync is cancelled.

package/cjs/cl.adobe.js

@@ -1,7 +1,7 @@
 (function(){var g={}; var _ = _ || {}
-var f=function(window){var vL=function(){this.l=this.f=null;this.a="";this.g=new _.D("clpp.adobe.AdobePlugin")},yL=function(a){a.f=new _.Yf;a.f.on(a.l,_.Ee,function(){return wL(a)});a.f.on(a.l,_.De,function(){s.Media.play(a.a,a.l.getPosition())});a.f.on(a.l,_.kd,function(){return xL(a)});a.f.on(a.l,_.ie,function(b){b=b.detail;switch(b.currentState){case _.Vl:a.a.length||xL(a);s.Media.play(a.a,a.l.getPosition());break;case _.Ul:case _.Ml:wL(a);break;case _.Ol:case _.Hl:case _.Sl:a.g.info("Close session for "+a.a+" in player state "+
-(b.currentState+".")),wL(a),s.Media.close(a.a),a.a=""}})},xL=function(a){var b=a.l.getLoadedSource();a.a=b?b.name||b.url:"";a.g.info("Open session for "+a.a+" with duration "+a.l.getDuration());s.Media.open(a.a,a.l.getDuration(),_.na)},wL=function(a){s.Media.stop(a.a,a.l.getPosition())},zL=function(){};_.u(vL,_.ap);vL.prototype.onPlayerCreated=function(a){window.s&&s.Media?(this.l=a,yL(this)):this.g.warn("Adobe API not available.")};
-vL.prototype.onPlayerWillDestroy=function(){this.f&&(this.f.release(),this.f=null);this.l=null;this.a=""};vL.prototype.id=function(){return"adobe"};_.A("clpp.adobe.AdobeAnalyticsPlugin",vL);vL.Id="adobe";zL.prototype.create=function(){return new vL};_.pn(new zL);};
+var f=function(window){var BM=function(){this.l=this.f=null;this.a="";this.g=new _.H("clpp.adobe.AdobePlugin")},EM=function(a){a.f=new _.bg;a.f.on(a.l,_.Ke,function(){return CM(a)});a.f.on(a.l,_.Je,function(){s.Media.play(a.a,a.l.getPosition())});a.f.on(a.l,_.rd,function(){return DM(a)});a.f.on(a.l,_.oe,function(b){b=b.detail;switch(b.currentState){case _.xm:a.a.length||DM(a);s.Media.play(a.a,a.l.getPosition());break;case _.wm:case _.om:CM(a);break;case _.qm:case _.jm:case _.um:a.g.info("Close session for "+a.a+" in player state "+
+(b.currentState+".")),CM(a),s.Media.close(a.a),a.a=""}})},DM=function(a){var b=a.l.getLoadedSource();a.a=b?b.name||b.url:"";a.g.info("Open session for "+a.a+" with duration "+a.l.getDuration());s.Media.open(a.a,a.l.getDuration(),_.sa)},CM=function(a){s.Media.stop(a.a,a.l.getPosition())},FM=function(){};_.v(BM,_.Gp);BM.prototype.onPlayerCreated=function(a){window.s&&s.Media?(this.l=a,EM(this)):this.g.warn("Adobe API not available.")};
+BM.prototype.onPlayerWillDestroy=function(){this.f&&(this.f.release(),this.f=null);this.l=null;this.a=""};BM.prototype.id=function(){return"adobe"};_.C("clpp.adobe.AdobeAnalyticsPlugin",BM);BM.Id="adobe";FM.prototype.create=function(){return new BM};_.Un(new FM);};
 if(typeof(module)!="undefined"&&module.exports){var x=require("./cl.core.js");_ = x._;(f.call(g,this));module.exports=g;}
 else if (typeof(define)!="undefined"&&define.amd) {define(["./cl.core"], function(c){_=c._;(f.call(g,this));return g;});}
 else{_=this.clpp._;(f.call(g,this));}

package/cjs/cl.airplay.js

@@ -1,7 +1,7 @@
 (function(){var g={}; var _ = _ || {}
-var f=function(window){var tL=function(){var a=this;this.a=this.l=null;this.j=this.f=this.h=!1;this.m=new _.oh(function(){a.l.play()["catch"](function(){})});this.g=new _.Yf},uL=function(){};_.u(tL,_.ap);_.h=tL.prototype;_.h.onPlayerCreated=function(a){this.l=a;this.a=a.getSurface().getMedia()};_.h.onContentWillLoad=function(){this.a&&(this.g.on(this.a,"webkitplaybacktargetavailabilitychanged",this.Mi.bind(this)),this.g.on(this.a,"webkitcurrentplaybacktargetiswirelesschanged",this.oj.bind(this)))};
-_.h.onPlayerWillRelease=function(){this.m.stop();this.g.release()};_.h.id=function(){return"airplay"};_.h.Mi=function(a){switch(a.availability){case "available":this.f=!0;break;case "not-available":this.f=!1}this.l.trigger(new _.E(_.Pb,{canCast:this.f}))};_.h.oj=function(){var a=(this.h=this.a.webkitCurrentPlaybackTargetIsWireless)?_.Ob:_.Nb;if(this.j||!this.l.isPaused()||this.l.getState()===_.Vl)this.j?this.l.play()["catch"](function(){}):this.m.$(.01);this.l.trigger(new _.E(a))};_.h.cb=function(){return this.h};
-_.h.Yd=function(){return this.f};_.h.Gj=function(){this.f&&(this.j=!this.l.isPaused(),this.a.webkitShowPlaybackTargetPicker())};_.A("clpp.airplay.AirPlayPlugin",tL);tL.prototype.showCastMenu=tL.prototype.Gj;tL.prototype.canCast=tL.prototype.Yd;tL.prototype.isCasting=tL.prototype.cb;tL.Id="airplay";uL.prototype.create=function(){return new tL};_.pn(new uL);};
+var f=function(window){var zM=function(){var a=this;this.a=this.l=null;this.j=this.f=this.h=!1;this.m=new _.Ah(function(){a.l.play()["catch"](function(){})});this.g=new _.bg},AM=function(){};_.v(zM,_.Gp);_.t=zM.prototype;_.t.onPlayerCreated=function(a){this.l=a;this.a=a.getSurface().getMedia()};_.t.onContentWillLoad=function(){this.a&&(this.g.on(this.a,"webkitplaybacktargetavailabilitychanged",this.Qi.bind(this)),this.g.on(this.a,"webkitcurrentplaybacktargetiswirelesschanged",this.qj.bind(this)))};
+_.t.onPlayerWillRelease=function(){this.m.stop();this.g.release()};_.t.id=function(){return"airplay"};_.t.Qi=function(a){switch(a.availability){case "available":this.f=!0;break;case "not-available":this.f=!1}this.l.trigger(new _.J(_.Wb,{canCast:this.f}))};_.t.qj=function(){var a=(this.h=this.a.webkitCurrentPlaybackTargetIsWireless)?_.Vb:_.Ub;if(this.j||!this.l.isPaused()||this.l.getState()===_.xm)this.j?this.l.play()["catch"](function(){}):this.m.$(.01);this.l.trigger(new _.J(a))};_.t.ib=function(){return this.h};
+_.t.de=function(){return this.f};_.t.Ij=function(){this.f&&(this.j=!this.l.isPaused(),this.a.webkitShowPlaybackTargetPicker())};_.C("clpp.airplay.AirPlayPlugin",zM);zM.prototype.showCastMenu=zM.prototype.Ij;zM.prototype.canCast=zM.prototype.de;zM.prototype.isCasting=zM.prototype.ib;zM.Id="airplay";AM.prototype.create=function(){return new zM};_.Un(new AM);};
 if(typeof(module)!="undefined"&&module.exports){var x=require("./cl.core.js");_ = x._;(f.call(g,this));module.exports=g;}
 else if (typeof(define)!="undefined"&&define.amd) {define(["./cl.core"], function(c){_=c._;(f.call(g,this));return g;});}
 else{_=this.clpp._;(f.call(g,this));}

package/cjs/cl.broadpeak.js

@@ -1,10 +1,10 @@
 (function(){var g={}; var _ = _ || {}
-var f=function(window){var lL=function(a,b){this.l=a;this.f=b;this.a=new _.Yf;this.g=!1},mL=function(a){var b=GenericPlayerApi.call(this)||this;b.l=a;b.a=_.ji();return b},nL=function(){this.h=this.f=this.a=this.g=this.l=null;this.j=new _.Yf},oL=function(a,b){var c=b.analyticsAddress||null,d=b.nanoCDNHost||null,e=b.broadpeakDomainNames||"",f=b.uuid||null;a.g||(a.g=SmartLib.getInstance(),a.g.init(c,d,e),typeof f===_.me&&a.g.setUUID(f))},pL=function(a,b){var c=b.customParameters||{};a.a=a.g.createStreamingSession();for(var d in c)a.a.setCustomParameter(d,
-c[d]);a.j.on(a.l,_.Xc,a.S.bind(a));a.h=new mL(a.l);a.a.attachPlayer(a.h)},qL=function(a,b){_.ag(a.j);a.f&&(a.f.release(),a.f=null);a.a&&(a.a.stopStreamingSession(b),a.a=null)},rL=function(){return!window.SmartLib||!window.GenericPlayerApi},sL=function(){};_.h=lL.prototype;_.h.init=function(){var a=this.l,b=this.a;b.on(a,_.ie,this.Mg.bind(this));b.on(a,_.hc,this.Kg.bind(this));b.on(a,"seek",this.Lg.bind(this))};
-_.h.Kg=function(a){a=a.detail;typeof a.bandwidth===_.zd&&this.f.notifyLayerSwitch(a.bandwidth/1E3)};_.h.Mg=function(a){var b=this.l,c=this.f;a=a.detail;var d=a.currentState;a.previousState===_.Ml&&c.notifyStallEnd(!b.isPaused());switch(d){case _.Ml:c.notifyStallStart();break;case _.Vl:this.g?c.notifyResume():(c.notifyFirstImage(),this.g=!0);break;case _.Ul:c.notifyPause()}};_.h.Lg=function(){var a=1E3*this.l.getPosition();this.f.notifySeek(a)};_.h.release=function(){this.a&&(_.ag(this.a),this.a=null)};_.u(mL,GenericPlayerApi);_.h=mL.prototype;_.h.getPlayerName=function(){return _.na};_.h.getVersion=function(){return _.ea};_.h.getOSName=function(){return this.a.os};_.h.getDeviceVersion=function(){return this.a.osVersion.name};_.h.getDeviceType=function(){return"browser"};_.h.getTotalDuration=function(){return this.l.isLive()?0:1E3*this.l.getDuration()};_.h.getCurrentPosition=function(){return 1E3*this.l.getPosition()};
-_.h.getCurrentBitrate=function(){var a=this.l.getStats();return(a?a.streamBandwidth:0)/1E3};_.u(nL,_.ap);_.h=nL.prototype;_.h.onPlayerCreated=function(a){this.l=a};_.h.onContentWillLoad=function(a,b){var c=this,d=a.getConfiguration().broadpeak;if(d){if(rL())return a.onError(new _.J(1,9,11E3));oL(this,d);pL(this,d);return this.a.getURL(b.url).then(function(e){if(e.isError()){var f=e.getDetailedErrorCode();e=e.getDetailedErrorMessage();c.l.onError(new _.J(1,9,11001,{bpkErrorCode:f,message:e}));qL(c,void 0)}else b.url=e.getURL(),c.f=new lL(c.l,c.h),c.f.init()})}};
-_.h.S=function(a){a=a.detail;if(7003===a.code)qL(this,SmartLib.BPFormatNotSupportedError);else if(a.severity===_.K)switch(a.category){case 3:qL(this,SmartLib.BPDecodingError);break;case 1:qL(this,SmartLib.BPNetworkingError);break;case 6:qL(this,SmartLib.BPAccessRightError);break;default:qL(this,SmartLib.BPUnspecifiedError)}};_.h.onPlayerWillRelease=function(){rL()||qL(this,SmartLib.BPSessionEndsNormally)};_.h.id=function(){return"broadpeak"};_.A("clpp.broadpeak.BroadpeakPlugin",nL);
-nL.isSdkMissing=rL;nL.Id="broadpeak";sL.prototype.create=function(){return new nL};_.pn(new sL);};
+var f=function(window){var rM=function(a,b){this.l=a;this.f=b;this.a=new _.bg;this.g=!1},sM=function(a){var b=GenericPlayerApi.call(this)||this;b.l=a;b.a=_.vi();return b},tM=function(){this.h=this.f=this.a=this.g=this.l=null;this.j=new _.bg},uM=function(a,b){var c=b.analyticsAddress||null,d=b.nanoCDNHost||null,e=b.broadpeakDomainNames||"",f=b.uuid||null;a.g||(a.g=SmartLib.getInstance(),a.g.init(c,d,e),typeof f===_.se&&a.g.setUUID(f))},vM=function(a,b){var c=b.customParameters||{};a.a=a.g.createStreamingSession();for(var d in c)a.a.setCustomParameter(d,
+c[d]);a.j.on(a.l,_.dd,a.S.bind(a));a.h=new sM(a.l);a.a.attachPlayer(a.h)},wM=function(a,b){_.eg(a.j);a.f&&(a.f.release(),a.f=null);a.a&&(a.a.stopStreamingSession(b),a.a=null)},xM=function(){return!window.SmartLib||!window.GenericPlayerApi},yM=function(){};_.t=rM.prototype;_.t.init=function(){var a=this.l,b=this.a;b.on(a,_.oe,this.Jg.bind(this));b.on(a,_.oc,this.Hg.bind(this));b.on(a,"seek",this.Ig.bind(this))};
+_.t.Hg=function(a){a=a.detail;typeof a.bandwidth===_.k&&this.f.notifyLayerSwitch(a.bandwidth/1E3)};_.t.Jg=function(a){var b=this.l,c=this.f;a=a.detail;var d=a.currentState;a.previousState===_.om&&c.notifyStallEnd(!b.isPaused());switch(d){case _.om:c.notifyStallStart();break;case _.xm:this.g?c.notifyResume():(c.notifyFirstImage(),this.g=!0);break;case _.wm:c.notifyPause()}};_.t.Ig=function(){var a=1E3*this.l.getPosition();this.f.notifySeek(a)};_.t.release=function(){this.a&&(_.eg(this.a),this.a=null)};_.v(sM,GenericPlayerApi);_.t=sM.prototype;_.t.getPlayerName=function(){return _.sa};_.t.getVersion=function(){return _.ia};_.t.getOSName=function(){return this.a.os};_.t.getDeviceVersion=function(){return this.a.osVersion.name};_.t.getDeviceType=function(){return"browser"};_.t.getTotalDuration=function(){return this.l.isLive()?0:1E3*this.l.getDuration()};_.t.getCurrentPosition=function(){return 1E3*this.l.getPosition()};
+_.t.getCurrentBitrate=function(){var a=this.l.getStats();return(a?a.streamBandwidth:0)/1E3};_.v(tM,_.Gp);_.t=tM.prototype;_.t.onPlayerCreated=function(a){this.l=a};_.t.onContentWillLoad=function(a,b){var c=this,d=a.getConfiguration().broadpeak;if(d){if(xM())return a.onError(new _.L(1,9,11E3));uM(this,d);vM(this,d);return this.a.getURL(b.url).then(function(e){if(e.isError()){var f=e.getDetailedErrorCode();e=e.getDetailedErrorMessage();c.l.onError(new _.L(1,9,11001,{bpkErrorCode:f,message:e}));wM(c,void 0)}else b.url=e.getURL(),c.f=new rM(c.l,c.h),c.f.init()})}};
+_.t.S=function(a){a=a.detail;if(7003===a.code)wM(this,SmartLib.BPFormatNotSupportedError);else if(a.severity===_.M)switch(a.category){case 3:wM(this,SmartLib.BPDecodingError);break;case 1:wM(this,SmartLib.BPNetworkingError);break;case 6:wM(this,SmartLib.BPAccessRightError);break;default:wM(this,SmartLib.BPUnspecifiedError)}};_.t.onPlayerWillRelease=function(){xM()||wM(this,SmartLib.BPSessionEndsNormally)};_.t.id=function(){return"broadpeak"};_.C("clpp.broadpeak.BroadpeakPlugin",tM);
+tM.isSdkMissing=xM;tM.Id="broadpeak";yM.prototype.create=function(){return new tM};_.Un(new yM);};
 if(typeof(module)!="undefined"&&module.exports){var x=require("./cl.core.js");_ = x._;(f.call(g,this));module.exports=g;}
 else if (typeof(define)!="undefined"&&define.amd) {define(["./cl.core"], function(c){_=c._;(f.call(g,this));return g;});}
 else{_=this.clpp._;(f.call(g,this));}