shaka-player 3.1.0 → 3.1.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,7 +44,7 @@ shaka.ui = {};
 shaka.util.FakeEvent = class {
   /**
    * @param {string} type
-   * @param {Object=} dict
+   * @param {Map.<string, Object>=} dict
    */
   constructor(type, dict) {}
 };
@@ -109,10 +109,7 @@ shaka.util.FakeEventTarget.ListenerType;
  * <ul>
  *   <li><a href="https://developer.mozilla.org/en-US/docs/Web/API/MediaError">MediaError</a>
  *   <li><a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Status">HTTP Codes</a>
- *   <li>
- *     <a href="https://docs.microsoft.com/en-us/windows/win32/wmdm/error-codes">PlayReady errors</a>
- *     or
- *     <a href="https://github.com/tpn/winsdk-10/blob/master/Include/10.0.16299.0/winrt/Windows.Media.Protection.PlayReadyErrors.h">more PlayReady errors</a>
+ *   <li><a href="https://hresult.info">Edge/PlayReady errors</a>
  * </ul>
  * @implements {shaka.extern.Error}
  * @extends {Error}
@@ -1107,12 +1104,12 @@ shaka.dependencies = class {
   /**
    * Registers a new dependency.
    * @param {shaka.dependencies.Allowed} key which is used for retrieving a
-   * dependency
+   *   dependency
    * @param {?} dep a dependency
    */
   static add(key, dep) {}
   /**
-   * Check if we have a dependency for the key
+   * Check if we have a dependency for the key.
    * @param {shaka.dependencies.Allowed} key key
    * @return {boolean}
    */
@@ -1438,7 +1435,7 @@ shaka.net.NetworkingEngine = class extends shaka.util.FakeEventTarget {
    * Makes a simple network request for the given URIs.
    * @param {!Array.<string>} uris
    * @param {shaka.extern.RetryParameters} retryParams
-   * @param {?function(BufferSource)=} streamDataCallback
+   * @param {?function(BufferSource):!Promise=} streamDataCallback
    * @return {shaka.extern.Request}
    */
   static makeRequest(uris, retryParams, streamDataCallback) {}
@@ -1884,13 +1881,16 @@ shaka.media.SegmentIndex = class {
   offset(offset) {}
   /**
    * Merges the given SegmentReferences.  Supports extending the original
-   * references only.  Will not replace old references or interleave new ones.
+   * references only.  Will replace old references with equivalent new ones, and
+   * keep any unique old ones.
    * Used, for example, by the DASH and HLS parser, where manifests may not list
    * all available references, so we must keep available references in memory to
    * fill the availability window.
    * @param {!Array.<!shaka.media.SegmentReference>} references The list of
    *   SegmentReferences, which must be sorted first by their start times
    *   (ascending) and second by their end times (ascending).
+   * @deprecated Not used directly by our own parsers, so will become private in
+   *   v4.  Use mergeAndEvict() instead.
    */
   merge(references) {}
   /**
@@ -1934,9 +1934,10 @@ shaka.media.SegmentIndex = class {
   /**
    * Returns a new iterator that initially points to the segment that contains
    * the given time.  Like the normal iterator, next() must be called first to
-   * get to the first element.
+   * get to the first element. Returns null if we do not find a segment at the
+   * requested time.
    * @param {number} time
-   * @return {!shaka.media.SegmentIterator}
+   * @return {?shaka.media.SegmentIterator}
    */
   getIteratorForTime(time) {}
   /**
@@ -2822,6 +2823,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 {
   /** */
@@ -2834,6 +2836,10 @@ shaka.ads.AdManager = class extends shaka.util.FakeEventTarget {
    * @override
    */
   initClientSide(adContainer, video) {}
+  /**
+   * @override
+   */
+  release() {}
   /**
   * @override
   */
@@ -3472,6 +3478,168 @@ shaka.polyfill = class {
    */
   static register(polyfill, priority) {}
 };
+/**
+ * @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() {}
+};
+/**
+ * @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}