shaka-player 3.2.0 → 3.2.4

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

@@ -32,9 +32,9 @@ shaka.offline = {};
 /** @const */
 shaka.text = {};
 /** @const */
-shaka.util = {};
-/** @const */
 shaka.ui = {};
+/** @const */
+shaka.util = {};
 
 /**
  * @summary Create an Event work-alike object based on the provided dictionary.
@@ -44,15 +44,28 @@ shaka.ui = {};
 shaka.util.FakeEvent = class {
   /**
    * @param {string} type
-   * @param {Object=} dict
+   * @param {Map.<string, Object>=} dict
    */
   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 {
   /** */
@@ -90,6 +103,10 @@ shaka.util.FakeEventTarget = class {
    * @override
    */
   dispatchEvent(event) {}
+  /**
+   * @override
+   */
+  release() {}
 };
 /**
  * These are the listener types defined in the closure extern for EventTarget.
@@ -299,10 +316,9 @@ shaka.util.Error.Code = {
  * 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
@@ -312,15 +328,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
@@ -541,6 +549,10 @@ shaka.text.Cue.prototype.id;
      * @override
      */
 shaka.text.Cue.prototype.nestedCues;
+/**
+     * @override
+     */
+shaka.text.Cue.prototype.isContainer;
 /**
      * @override
      */
@@ -1277,18 +1289,6 @@ shaka.net.NetworkingEngine.PluginPriority = {
   'PREFERRED': 2,
   'APPLICATION': 3
 };
-/**
- * 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
@@ -1640,8 +1640,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>}
@@ -1675,6 +1679,12 @@ shaka.media.SegmentReference = class {
    * @return {?string}
    */
   getTilesLayout() {}
+  /**
+   * Returns the segment's explicit tile duration.
+   * Only defined in image segments.
+   * @return {?number}
+   */
+  getTileDuration() {}
 };
 /**
  * PresentationTimeline.
@@ -2864,6 +2874,7 @@ shaka.ads.ServerSideAd = class {
 /**
  * A class responsible for ad-related interactions.
  * @implements {shaka.extern.IAdManager}
+ * @implements {shaka.util.IReleasable}
  */
 shaka.ads.AdManager = class extends shaka.util.FakeEventTarget {
   /** */
@@ -2876,6 +2887,10 @@ shaka.ads.AdManager = class extends shaka.util.FakeEventTarget {
    * @override
    */
   initClientSide(adContainer, video) {}
+  /**
+   * @override
+   */
+  release() {}
   /**
   * @override
   */
@@ -2899,6 +2914,11 @@ shaka.ads.AdManager = class extends shaka.util.FakeEventTarget {
    * @override
    */
   replaceServerSideAdTagParameters(adTagParameters) {}
+  /**
+   * @return {!Array.<!shaka.extern.AdCuePoint>}
+   * @override
+   */
+  getServerSideCuePoints() {}
   /**
    * @return {shaka.extern.AdsStats}
    * @override
@@ -3514,6 +3534,189 @@ shaka.polyfill = class {
    */
   static register(polyfill, priority) {}
 };
+/**
+ * @summary A polyfill to add support for the ARIAMixin interface mixin, for
+ * browsers that do not implement it (e.g. Firefox).
+ * Note that IE also does not support ARIAMixin, but this polyfill does not work
+ * for that platform, as it relies on getters and setters.
+ * @see https://w3c.github.io/aria/#ARIAMixin
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Element
+ */
+shaka.polyfill.Aria = class {
+  /**
+   * Install the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @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
+ */
+shaka.polyfill.EncryptionScheme = class {
+  /**
+   * Install the polyfill if needed.
+   * @suppress {missingRequire}
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to unify fullscreen APIs across browsers.
+ * Many browsers have prefixed fullscreen methods on Element and document.
+ * See {@link https://mzl.la/2K0xcHo Using fullscreen mode} on MDN for more
+ * information.
+ */
+shaka.polyfill.Fullscreen = class {
+  /**
+   * Install the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to patch math round bug on some browsers.
+ * @see https://stackoverflow.com/q/12830742
+ */
+shaka.polyfill.MathRound = class {
+  /**
+   * Install the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to provide navigator.mediaCapabilities on all browsers.
+ * This is necessary for Tizen 3, Xbox One and possibly others we have yet to
+ * discover.
+ */
+shaka.polyfill.MediaCapabilities = class {
+  /**
+   * Install the polyfill if needed.
+   * @suppress {const}
+   */
+  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.
+ */
+shaka.polyfill.MediaSource = class {
+  /**
+   * Install the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill for systems that do not implement screen.orientation.
+ * For now, this only handles systems that implement the deprecated
+ * window.orientation feature... e.g. iPad.
+ */
+shaka.polyfill.Orientation = class {
+  /**
+   * Install the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to implement modern, standardized EME on top of Apple's
+ * prefixed EME in Safari.
+ */
+shaka.polyfill.PatchedMediaKeysApple = class {
+  /**
+   * Installs the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to implement
+ * {@link https://bit.ly/EmeMar15 EME draft 12 March 2015}
+ * on top of ms-prefixed
+ * {@link https://www.w3.org/TR/2014/WD-encrypted-media-20140218/ EME v20140218}
+ */
+shaka.polyfill.PatchedMediaKeysMs = class {
+  /**
+   * Installs the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to stub out
+ * {@link https://bit.ly/EmeMar15 EME draft 12 March 2015} on browsers without
+ * EME.
+ * All methods will fail.
+ */
+shaka.polyfill.PatchedMediaKeysNop = class {
+  /**
+   * Installs the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to implement
+ * {@link https://bit.ly/EmeMar15 EME draft 12 March 2015} on top of
+ * webkit-prefixed {@link https://bit.ly/Eme01b EME v0.1b}.
+ */
+shaka.polyfill.PatchedMediaKeysWebkit = class {
+  /**
+   * Installs the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to provide PiP support in Safari.
+ * Note that Safari only supports PiP on video elements, not audio.
+ */
+shaka.polyfill.PiPWebkit = class {
+  /**
+   * Install the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to provide navigator.storage.estimate in old
+ * webkit browsers.
+ * See: https://developers.google.com/web/updates/2017/08/estimating-available-storage-space#the-present
+ */
+shaka.polyfill.StorageEstimate = class {
+  /**
+   * Install the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to silence the play() Promise in HTML5 video.
+ */
+shaka.polyfill.VideoPlayPromise = class {
+  /**
+   * Install the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to provide MSE VideoPlaybackQuality metrics.
+ * Many browsers do not yet provide this API, and Chrome currently provides
+ * similar data through individual prefixed attributes on HTMLVideoElement.
+ */
+shaka.polyfill.VideoPlaybackQuality = class {
+  /**
+   * Install the polyfill if needed.
+   */
+  static install() {}
+};
+/**
+ * @summary A polyfill to provide VTTCue.
+ */
+shaka.polyfill.VTTCue = class {
+  /**
+   * Install the polyfill if needed.
+   */
+  static install() {}
+};
 /**
  * LRC file format: https://en.wikipedia.org/wiki/LRC_(file_format)
  * @implements {shaka.extern.TextParser}