shaka-player 3.3.0 → 3.3.3

package/dist/shaka-player.ui.externs.js

@@ -50,11 +50,24 @@ shaka.util.FakeEvent = class {
    */
   constructor(type, dict) {}
 };
+/**
+ * An interface to standardize how objects release internal references
+ * synchronously. If an object needs to asynchronously release references, then
+ * it should use 'shaka.util.IDestroyable'.
+ * @interface
+ */
+shaka.util.IReleasable = class {
+  /**
+   * Request that this object release all internal references.
+   */
+  release() {}
+};
 /**
  * @summary A work-alike for EventTarget.  Only DOM elements may be true
  * EventTargets, but this can be used as a base class to provide event dispatch
  * to non-DOM classes.  Only FakeEvents should be dispatched.
  * @implements {EventTarget}
+ * @implements {shaka.util.IReleasable}
  */
 shaka.util.FakeEventTarget = class {
   /** */
@@ -92,6 +105,10 @@ shaka.util.FakeEventTarget = class {
    * @override
    */
   dispatchEvent(event) {}
+  /**
+   * @override
+   */
+  release() {}
 };
 /**
  * These are the listener types defined in the closure extern for EventTarget.
@@ -445,10 +462,9 @@ shaka.util.LanguageUtils = class {
  * strings that are expected to be displayed to the user.
  * If a string is not available, it will return the localized
  * form in the closest related locale.
- * @implements {EventTarget}
  * @final
  */
-shaka.ui.Localization = class {
+shaka.ui.Localization = class extends shaka.util.FakeEventTarget {
   /**
    * @param {string} fallbackLocale
    *    The fallback locale that should be used. It will be assumed that this
@@ -458,15 +474,7 @@ shaka.ui.Localization = class {
   /**
    * @override
    */
-  addEventListener(type, listener, options) {}
-  /**
-   * @override
-   */
-  removeEventListener(type, listener, options) {}
-  /**
-   * @override
-   */
-  dispatchEvent(event) {}
+  release() {}
   /**
    * Request the localization system to change which locale it serves. If any of
    * of the preferred locales cannot be found, the localization system will fire
@@ -695,6 +703,10 @@ shaka.text.Cue.prototype.id;
      * @override
      */
 shaka.text.Cue.prototype.nestedCues;
+/**
+     * @override
+     */
+shaka.text.Cue.prototype.isContainer;
 /**
      * @override
      */
@@ -1456,18 +1468,6 @@ shaka.net.NetworkingEngine.OnHeadersReceived;
  * reason (e.g. even if the download was aborted).
  */
 shaka.net.NetworkingEngine.OnDownloadFailed;
-/**
- * An interface to standardize how objects release internal references
- * synchronously. If an object needs to asynchronously release references, then
- * it should use 'shaka.util.IDestroyable'.
- * @interface
- */
-shaka.util.IReleasable = class {
-  /**
-   * Request that this object release all internal references.
-   */
-  release() {}
-};
 /**
  * @summary
  * An EventManager maintains a collection of "event
@@ -1821,8 +1821,12 @@ shaka.media.SegmentReference = class {
    *   The value is a grid-item-dimension consisting of two positive decimal
    *   integers in the format: column-x-row ('4x3'). It describes the
    *   arrangement of Images in a Grid. The minimum valid LAYOUT is '1x1'.
+   * @param {?number=} tileDuration
+   *  The explicit duration of an individual tile within the tiles grid.
+   *  If not provided, the duration should be automatically calculated based on
+   *  the duration of the reference.
    */
-  constructor(startTime, endTime, uris, startByte, endByte, initSegmentReference, timestampOffset, appendWindowStart, appendWindowEnd, partialReferences, tilesLayout) {}
+  constructor(startTime, endTime, uris, startByte, endByte, initSegmentReference, timestampOffset, appendWindowStart, appendWindowEnd, partialReferences, tilesLayout, tileDuration) {}
   /**
    * Creates and returns the URIs of the resource containing the segment.
    * @return {!Array.<string>}
@@ -1856,6 +1860,12 @@ shaka.media.SegmentReference = class {
    * @return {?string}
    */
   getTilesLayout() {}
+  /**
+   * Returns the segment's explicit tile duration.
+   * Only defined in image segments.
+   * @return {?number}
+   */
+  getTileDuration() {}
 };
 /**
  * PresentationTimeline.
@@ -1976,8 +1986,9 @@ shaka.media.PresentationTimeline = class {
    * Gets the presentation's current segment availability end time.  Segments
    * starting after this time should be assumed to be unavailable.
    * @return {number} The current segment availability end time, in seconds,
-   *   relative to the start of the presentation.  Always returns the
-   *   presentation's duration for video-on-demand.
+   *   relative to the start of the presentation.  For VOD, the availability
+   *   end time is the content's duration.  If the Player's playRangeEnd
+   *   configuration is used, this can override the duration.
    */
   getSegmentAvailabilityEnd() {}
   /**
@@ -3783,7 +3794,7 @@ shaka.polyfill.Aria = class {
  * @summary A polyfill to add support for EncryptionScheme queries in EME.
  * @see https://wicg.github.io/encrypted-media-encryption-scheme/
  * @see https://github.com/w3c/encrypted-media/pull/457
- * @see https://github.com/google/eme-encryption-scheme-polyfill
+ * @see https://github.com/shaka-project/eme-encryption-scheme-polyfill
  */
 shaka.polyfill.EncryptionScheme = class {
   /**
@@ -3826,6 +3837,13 @@ shaka.polyfill.MediaCapabilities = class {
    */
   static install() {}
 };
+/**
+ * A copy of the MediaCapabilities instance, to prevent Safari from
+ * garbage-collecting the polyfilled method on it.  We make it public and export
+ * it to ensure that it is not stripped out by the compiler.
+ * @type {MediaCapabilities}
+ */
+shaka.polyfill.MediaCapabilities.originalMcap;
 /**
  * @summary A polyfill to patch MSE bugs.
  */
@@ -3921,6 +3939,16 @@ shaka.polyfill.StorageEstimate = class {
    */
   static install() {}
 };
+/**
+ * @summary A polyfill to provide Symbol.prototype.description in all browsers.
+ * See: https://caniuse.com/mdn-javascript_builtins_symbol_description
+ */
+shaka.polyfill.Symbol = class {
+  /**
+   * Install the polyfill if needed.
+   */
+  static install() {}
+};
 /**
  * @summary A polyfill to silence the play() Promise in HTML5 video.
  */