shaka-player 4.12.8 → 4.13.0

package/externs/lcevc.js

@@ -5,11 +5,11 @@
  */
 
 /**
-* @fileoverview Externs for LcevcDec
-* compiler.
-*
-* @externs
-*/
+ * @fileoverview Externs for LcevcDec
+ * compiler.
+ *
+ * @externs
+ */
 
 // This empty namespace is declared to check if LcevcDec libraries are loaded.
 /** @const */
@@ -18,9 +18,9 @@ var libDPIModule = {};
 var LCEVCdec = {};
 
 /**
-* LCEVC Dec constructor
-* @constructor
-*/
+ * LCEVC Dec constructor
+ * @constructor
+ */
 LCEVCdec.LCEVCdec = class {
   /**
    * @param {HTMLVideoElement} media

package/externs/mediakeys.js

@@ -13,6 +13,6 @@
 
 /**
  * @param {Object} policy
- * @return {!Promise.<string>}
+ * @return {!Promise<string>}
  */
 MediaKeys.prototype.getStatusForPolicy = function(policy) {};

package/externs/mediasession.js

@@ -37,8 +37,9 @@ const MediaSession = class {
     /** @type {string} */
     this.type = type;
 
-    /** @type {!function(!{action: string, seekOffset: ?number,
-     *                     seekTime: ?number})}
+    /**
+     * @type {!function(!{action: string, seekOffset: ?number,
+     *                   seekTime: ?number})}
      */
     this.callback = callback;
   }

package/externs/mediatailor.js

@@ -29,10 +29,10 @@ mediaTailor.SessionResponse;
 
 /**
  * @typedef {{
- *   avails: !Array.<mediaTailor.AdBreak>
+ *   avails: !Array<mediaTailor.AdBreak>
  * }}
  *
- * @property {!Array.<mediaTailor.AdBreak>} avails
+ * @property {!Array<mediaTailor.AdBreak>} avails
  * @exportDoc
  */
 mediaTailor.TrackingResponse;
@@ -40,17 +40,17 @@ mediaTailor.TrackingResponse;
 
 /**
  * @typedef {{
- *   adBreakTrackingEvents: !Array.<mediaTailor.TrackingEvent>,
- *   ads: !Array.<mediaTailor.Ad>,
+ *   adBreakTrackingEvents: !Array<mediaTailor.TrackingEvent>,
+ *   ads: !Array<mediaTailor.Ad>,
  *   durationInSeconds: number,
- *   nonLinearAdsList: !Array.<mediaTailor.Ad>,
+ *   nonLinearAdsList: !Array<mediaTailor.Ad>,
  *   startTimeInSeconds: number
  * }}
  *
- * @property {!Array.<mediaTailor.TrackingEvent>} adBreakTrackingEvents
- * @property {!Array.<mediaTailor.Ad>} ads
+ * @property {!Array<mediaTailor.TrackingEvent>} adBreakTrackingEvents
+ * @property {!Array<mediaTailor.Ad>} ads
  * @property {number} durationInSeconds
- * @property {!Array.<mediaTailor.Ad>} nonLinearAdsList
+ * @property {!Array<mediaTailor.Ad>} nonLinearAdsList
  * @property {number} startTimeInSeconds
  * @exportDoc
  */
@@ -68,8 +68,8 @@ mediaTailor.AdBreak;
  *   durationInSeconds: number,
  *   skipOffset: ?string,
  *   startTimeInSeconds: number,
- *   nonLinearAdList: !Array.<mediaTailor.NonLinearAd>,
- *   trackingEvents: !Array.<mediaTailor.TrackingEvent>
+ *   nonLinearAdList: !Array<mediaTailor.NonLinearAd>,
+ *   trackingEvents: !Array<mediaTailor.TrackingEvent>
  * }}
  *
  * @property {string} adId
@@ -81,8 +81,8 @@ mediaTailor.AdBreak;
  * @property {number} durationInSeconds
  * @property {?string} skipOffset
  * @property {number} startTimeInSeconds
- * @property {!Array.<mediaTailor.NonLinearAd>} nonLinearAdList
- * @property {!Array.<mediaTailor.TrackingEvent>} trackingEvents
+ * @property {!Array<mediaTailor.NonLinearAd>} nonLinearAdList
+ * @property {!Array<mediaTailor.TrackingEvent>} trackingEvents
  * @exportDoc
  */
 mediaTailor.Ad;
@@ -119,11 +119,11 @@ mediaTailor.NonLinearAd;
 
 /**
  * @typedef {{
- *   beaconUrls: !Array.<string>,
+ *   beaconUrls: !Array<string>,
  *   eventType: string
  * }}
  *
- * @property {!Array.<string>} beaconUrls
+ * @property {!Array<string>} beaconUrls
  * @property {string} eventType
  * @exportDoc
  */
@@ -136,10 +136,10 @@ var mediaTailorExternalResource = {};
 
 /**
  * @typedef {{
- *   apps: !Array.<mediaTailorExternalResource.App>
+ *   apps: !Array<mediaTailorExternalResource.App>
  * }}
  *
- * @property {!Array.<mediaTailorExternalResource.App>} apps
+ * @property {!Array<mediaTailorExternalResource.App>} apps
  * @exportDoc
  */
 mediaTailorExternalResource.Response;
@@ -173,10 +173,10 @@ mediaTailorExternalResource.AppPlaceholder;
 
 /**
  * @typedef {{
- *   source: !Array.<mediaTailorExternalResource.AppDataSource>
+ *   source: !Array<mediaTailorExternalResource.AppDataSource>
  * }}
  *
- * @property {!Array.<mediaTailorExternalResource.AppDataSource>} source
+ * @property {!Array<mediaTailorExternalResource.AppDataSource>} source
  * @exportDoc
  */
 mediaTailorExternalResource.AppData;

package/externs/pictureinpicture.js

@@ -51,6 +51,46 @@ HTMLMediaElement.prototype.webkitSupportsPresentationMode = function(mode) {};
 HTMLMediaElement.prototype.webkitPresentationMode;
 
 
+/**
+ * @constructor
+ * @implements {EventTarget}
+ */
+function PictureInPictureWindow() {}
+
+
+/** @type {number} */
+PictureInPictureWindow.prototype.width;
+
+
+/** @type {number} */
+PictureInPictureWindow.prototype.height;
+
+
+/** @override */
+PictureInPictureWindow.prototype.addEventListener =
+    function(type, listener, options) {};
+
+
+/** @override */
+PictureInPictureWindow.prototype.removeEventListener =
+    function(type, listener, options) {};
+
+
+/** @override */
+PictureInPictureWindow.prototype.dispatchEvent = function(event) {};
+
+
+/**
+ * @constructor
+ * @extends {Event}
+ */
+function PictureInPictureEvent() {}
+
+
+/** @type {PictureInPictureWindow} */
+PictureInPictureEvent.prototype.pictureInPictureWindow;
+
+
 /**
  * @typedef {{
  *   width: (number|undefined),
@@ -69,7 +109,7 @@ function DocumentPictureInPicture() {}
 
 /**
  * @param {DocumentPictureInPictureOptions} options
- * @return {!Promise.<Window>}
+ * @return {!Promise<Window>}
  */
 DocumentPictureInPicture.prototype.requestWindow = function(options) {};
 

package/externs/playstation.js

@@ -20,12 +20,12 @@ msdk.device = {};
 
 
 /**
- * @return {!Promise.<{resolution: string}>}
+ * @return {!Promise<{resolution: string}>}
  */
 msdk.device.getDisplayInfo = function() {};
 
 
 /**
- * @return {!Promise.<{resolution: string}>}
+ * @return {!Promise<{resolution: string}>}
  */
 msdk.device.getDisplayInfoImmediate = function() {};

package/externs/prefixed_eme.js

@@ -49,7 +49,7 @@ HTMLMediaElement.prototype.generateKeyRequest =
  * @param {string} mimeType
  * @param {string=} keySystem
  * @return {string} '', 'maybe', or 'probably'
- * @override the standard one-argument version
+ * @override
  */
 HTMLVideoElement.prototype.canPlayType =
     function(mimeType, keySystem) {};

package/externs/shaka/abortable.js

@@ -11,7 +11,7 @@
 
 /**
  * A representation of an abortable operation.  Note that these are not
- * cancelable.  Cancelation implies undoing what has been done so far,
+ * cancelable.  Cancellation implies undoing what has been done so far,
  * whereas aborting only means that further work is stopped.
  *
  * @interface
@@ -26,7 +26,7 @@ shaka.extern.IAbortableOperation = class {
      * aborted.  Aborted operations should be rejected with a shaka.util.Error
      * object using the error code OPERATION_ABORTED.
      *
-     * @const {!Promise.<T>}
+     * @const {!Promise<T>}
      * @exportDoc
      */
     this.promise;
@@ -34,7 +34,7 @@ shaka.extern.IAbortableOperation = class {
 
   /**
    * Can be called by anyone holding this object to abort the underlying
-   * operation.  This is not cancelation, and will not necessarily result in
+   * operation.  This is not cancellation, and will not necessarily result in
    * any work being undone.  abort() should return a Promise which is resolved
    * when the underlying operation has been aborted.  The returned Promise
    * should never be rejected.
@@ -49,7 +49,7 @@ shaka.extern.IAbortableOperation = class {
    * @param {function(boolean)} onFinal A callback to be invoked after the
    *   operation succeeds or fails.  The boolean argument is true
    *   if the operation succeeded and false if it failed.
-   * @return {!shaka.extern.IAbortableOperation.<T>} Returns this.
+   * @return {!shaka.extern.IAbortableOperation<T>} Returns this.
    * @exportDoc
    */
   finally(onFinal) {}

package/externs/shaka/abr_manager.js

@@ -53,7 +53,7 @@ shaka.extern.AbrManager = class {
   /**
    * Updates manager's variants collection.
    *
-   * @param {!Array.<!shaka.extern.Variant>} variants
+   * @param {!Array<!shaka.extern.Variant>} variants
    * @exportDoc
    */
   setVariants(variants) {}

package/externs/shaka/ads.js

@@ -11,7 +11,7 @@
 
 /**
  * @typedef {{
- *   loadTimes: !Array.<number>,
+ *   loadTimes: !Array<number>,
  *   averageLoadTime: number,
  *   started: number,
  *   playedCompletely: number,
@@ -60,6 +60,7 @@ shaka.extern.AdCuePoint;
 /**
  * @typedef {{
  *   id: ?string,
+ *   groupId: ?string,
  *   startTime: number,
  *   endTime: ?number,
  *   uri: string,
@@ -73,7 +74,9 @@ shaka.extern.AdCuePoint;
  *   once: boolean,
  *   pre: boolean,
  *   post: boolean,
- *   timelineRange: boolean
+ *   timelineRange: boolean,
+ *   loop: boolean,
+ *   overlay: ?shaka.extern.AdInterstitialOverlay
  * }}
  *
  * @description
@@ -81,6 +84,8 @@ shaka.extern.AdCuePoint;
  *
  * @property {?string} id
  *   The id of the interstitial.
+ * @property {?string} groupId
+ *   The group id of the interstitial.
  * @property {number} startTime
  *   The start time of the interstitial.
  * @property {?number} endTime
@@ -119,10 +124,39 @@ shaka.extern.AdCuePoint;
  * @property {boolean} timelineRange
  *   Indicates whether the  interstitial should be presented in a timeline UI
  *   as a single point or as a range.
+ * @property {boolean} loop
+ *   Indicates that the interstitials should play in loop.
+ *   Only applies if the interstitials is an overlay.
+ *   Only supported when using multiple video elements for interstitials.
+ * @property {?shaka.extern.AdInterstitialOverlay} overlay
+ *   Indicates the characteristics of the overlay
+ *   Only supported when using multiple video elements for interstitials.
+ * @exportDoc
  */
 shaka.extern.AdInterstitial;
 
 
+/**
+ * @typedef {{
+ *   viewport: {x: number, y: number},
+ *   topLeft: {x: number, y: number},
+ *   size: {x: number, y: number}
+ * }}
+ *
+ * @description
+ * Contains the ad interstitial overlay info.
+ *
+ * @property {{x: number, y: number}} viewport
+ *   The viewport in pixels.
+ * @property {{x: number, y: number}} topLeft
+ *   The topLeft in pixels.
+ * @property {{x: number, y: number}} size
+ *   The size in pixels.
+ * @exportDoc
+ */
+shaka.extern.AdInterstitialOverlay;
+
+
 /**
  * An object that's responsible for all the ad-related logic
  * in the player.
@@ -184,7 +218,7 @@ shaka.extern.IAdManager = class extends EventTarget {
    * @param {string} url
    * @param {Object} adsParams
    * @param {string=} backupUrl
-   * @return {!Promise.<string>}
+   * @return {!Promise<string>}
    */
   requestMediaTailorStream(url, adsParams, backupUrl) {}
 
@@ -202,7 +236,7 @@ shaka.extern.IAdManager = class extends EventTarget {
   /**
    * @param {!google.ima.dai.api.StreamRequest} imaRequest
    * @param {string=} backupUrl
-   * @return {!Promise.<string>}
+   * @return {!Promise<string>}
    */
   requestServerSideStream(imaRequest, backupUrl) {}
 
@@ -212,12 +246,12 @@ shaka.extern.IAdManager = class extends EventTarget {
   replaceServerSideAdTagParameters(adTagParameters) {}
 
   /**
-   * @return {!Array.<!shaka.extern.AdCuePoint>}
+   * @return {!Array<!shaka.extern.AdCuePoint>}
    */
   getServerSideCuePoints() {}
 
   /**
-   * @return {!Array.<!shaka.extern.AdCuePoint>}
+   * @return {!Array<!shaka.extern.AdCuePoint>}
    */
   getCuePoints() {}
 
@@ -274,6 +308,11 @@ shaka.extern.IAdManager = class extends EventTarget {
    * @return {!Promise}
    */
   addAdUrlInterstitial(url) {}
+
+  /**
+   * @return {shaka.Player}
+   */
+  getInterstitialPlayer() {}
 };
 
 

package/externs/shaka/cea.js

@@ -72,7 +72,7 @@ shaka.extern.ICaptionDecoder = class {
   /**
    * Decodes all currently extracted packets and then clears them.
    * This should be called once for a set of extracts (see comment on extract).
-   * @return {!Array.<!shaka.extern.ICaptionDecoder.ClosedCaption>}
+   * @return {!Array<!shaka.extern.ICaptionDecoder.ClosedCaption>}
    * @exportDoc
    */
   decode() {}
@@ -87,7 +87,7 @@ shaka.extern.ICaptionDecoder = class {
 
   /**
    * Returns the streams that the CEA decoder found.
-   * @return {!Array.<string>}
+   * @return {!Array<string>}
    * @exportDoc
    */
   getStreams() {}

package/externs/shaka/codecs.js

@@ -14,7 +14,7 @@
  *   packetLength: number,
  *   pts: ?number,
  *   dts: ?number,
- *   nalus: !Array.<!shaka.extern.VideoNalu>
+ *   nalus: !Array<!shaka.extern.VideoNalu>
  * }}
  *
  * @summary MPEG_PES.
@@ -22,7 +22,7 @@
  * @property {number} packetLength
  * @property {?number} pts
  * @property {?number} dts
- * @property {!Array.<!shaka.extern.VideoNalu>} nalus
+ * @property {!Array<!shaka.extern.VideoNalu>} nalus
  */
 shaka.extern.MPEG_PES;
 
@@ -34,7 +34,7 @@ shaka.extern.MPEG_PES;
  *   isKeyframe: boolean,
  *   pts: ?number,
  *   dts: ?number,
- *   nalus: !Array.<!shaka.extern.VideoNalu>
+ *   nalus: !Array<!shaka.extern.VideoNalu>
  * }}
  *
  * @summary VideoSample.
@@ -43,7 +43,7 @@ shaka.extern.MPEG_PES;
  * @property {boolean} isKeyframe
  * @property {?number} pts
  * @property {?number} dts
- * @property {!Array.<!shaka.extern.VideoNalu>} nalus
+ * @property {!Array<!shaka.extern.VideoNalu>} nalus
  */
 shaka.extern.VideoSample;
 

package/externs/shaka/drm_info.js

@@ -38,7 +38,7 @@ shaka.extern.InitDataOverride;
  * @typedef {{
  *   keySystem: string,
  *   encryptionScheme: string,
- *   keySystemUris: (Set.<string>|undefined),
+ *   keySystemUris: (Set<string>|undefined),
  *   licenseServerUri: string,
  *   distinctiveIdentifierRequired: boolean,
  *   persistentStateRequired: boolean,
@@ -47,8 +47,8 @@ shaka.extern.InitDataOverride;
  *   serverCertificate: Uint8Array,
  *   serverCertificateUri: string,
  *   sessionType: string,
- *   initData: Array.<!shaka.extern.InitDataOverride>,
- *   keyIds: Set.<string>
+ *   initData: Array<!shaka.extern.InitDataOverride>,
+ *   keyIds: Set<string>
  * }}
  *
  * @description
@@ -60,7 +60,7 @@ shaka.extern.InitDataOverride;
  * @property {string} encryptionScheme
  *   <i>Required.</i> <br>
  *   The encryption scheme, e.g., "cenc", "cbcs", "cbcs-1-9".
- * @property {(Set.<string>|undefined)} keySystemUris
+ * @property {(Set<string>|undefined)} keySystemUris
  *   <i>Optional.</i> <br>
  *   The key system uri, e.g., "skd://" for fairplay.
  * @property {string} licenseServerUri
@@ -95,11 +95,11 @@ shaka.extern.InitDataOverride;
  *   <i>Defaults to '', e.g., server certificate will be requested from the
  *   given URI if serverCertificate is not provided. Can be filled in by
  *   advanced DRM config.</i>
- * @property {Array.<!shaka.extern.InitDataOverride>} initData
+ * @property {Array<!shaka.extern.InitDataOverride>} initData
  *   <i>Defaults to [], e.g., no override.</i> <br>
  *   A list of initialization data which override any initialization data found
  *   in the content.  See also shaka.extern.InitDataOverride.
- * @property {Set.<string>} keyIds
+ * @property {Set<string>} keyIds
  *   <i>Defaults to the empty Set</i> <br>
  *   If not empty, contains the default key IDs for this key system, as
  *   lowercase hex strings.

package/externs/shaka/error.js

@@ -13,16 +13,16 @@
 /**
  * @typedef {{
  *   hasAppRestrictions: boolean,
- *   missingKeys: !Array.<string>,
- *   restrictedKeyStatuses: !Array.<string>
+ *   missingKeys: !Array<string>,
+ *   restrictedKeyStatuses: !Array<string>
  * }}
  *
  * @property {boolean} hasAppRestrictions
  *   Whether there are streams that are restricted due to app-provided
  *   restrictions.
- * @property {!Array.<string>} missingKeys
+ * @property {!Array<string>} missingKeys
  *   The key IDs that were missing.
- * @property {!Array.<string>} restrictedKeyStatuses
+ * @property {!Array<string>} restrictedKeyStatuses
  *   The restricted EME key statuses that the streams had.  For example,
  *   'output-restricted' would mean streams couldn't play due to restrictions
  *   on the output device (e.g. HDCP).
@@ -56,7 +56,7 @@ shaka.extern.Error = class {
     this.code;
 
     /**
-     * @const {!Array.<*>}
+     * @const {!Array<*>}
      * @exportDoc
      */
     this.data;