shaka-player 4.5.0 → 4.6.1

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

@@ -225,7 +225,6 @@ shaka.util.Error.Code = {
   'TEXT_ONLY_WEBVTT_SRC_EQUALS': 2013,
   'MISSING_TEXT_PLUGIN': 2014,
   'CHAPTERS_TRACK_FAILED': 2015,
-  'CANNOT_ADD_EXTERNAL_THUMBNAILS_TO_SRC_EQUALS': 2016,
   'UNSUPPORTED_EXTERNAL_THUMBNAILS_URI': 2017,
   'BUFFER_READ_OUT_OF_BOUNDS': 3000,
   'JS_INTEGER_OVERFLOW': 3001,
@@ -548,6 +547,11 @@ shaka.ui.Localization = class extends shaka.util.FakeEventTarget {
    * @return {string}
    */
   resolve(id) {}
+  /**
+   * The locales currently used. An empty set means "no preference".
+   * @return {!Set.<string>}
+   */
+  getCurrentLocales() {}
 };
 /**
  * An enum for how the localization system should resolve conflicts between old
@@ -590,13 +594,6 @@ shaka.ui.Localization.LOCALE_CHANGED;
  * @const {string}
  */
 shaka.ui.Localization.LOCALE_UPDATED;
-/**
- * @enum {string}
- */
-shaka.config.CodecSwitchingStrategy = {
-  RELOAD: 'reload',
-  SMOOTH: 'smooth'
-};
 /**
  * @summary A set of BufferSource utility functions.
  */
@@ -630,6 +627,18 @@ shaka.util.BufferUtils = class {
    * @return {!Uint8Array}
    */
   static toUint8(data, offset, length) {}
+  /**
+   * Creates a new Uint16Array view on the same buffer.  This clamps the values
+   * to be within the same view (i.e. you can't use this to move past the end
+   * of the view, even if the underlying buffer is larger).  However, you can
+   * pass a negative offset to access the data before the view.
+   * @param {BufferSource} data
+   * @param {number=} offset The offset from the beginning of this data's view
+   *   to start the new view at.
+   * @param {number=} length The byte length of the new view.
+   * @return {!Uint16Array}
+   */
+  static toUint16(data, offset, length) {}
   /**
    * Creates a DataView over the given buffer.
    * @see toUint8
@@ -1312,9 +1321,11 @@ shaka.abr.SimpleAbrManager = class {
    */
   init(switchCallback) {}
   /**
+   * @param {boolean=} preferFastSwitching
+   * @return {shaka.extern.Variant}
    * @override
    */
-  chooseVariant() {}
+  chooseVariant(preferFastSwitching) {}
   /**
    * @override
    */
@@ -1326,7 +1337,7 @@ shaka.abr.SimpleAbrManager = class {
   /**
    * @override
    */
-  segmentDownloaded(deltaTimeMs, numBytes) {}
+  segmentDownloaded(deltaTimeMs, numBytes, allowSwitch) {}
   /**
    * @override
    */
@@ -1357,6 +1368,13 @@ shaka.config.AutoShowText = {
   'IF_PREFERRED_TEXT_LANGUAGE': 2,
   'IF_SUBTITLES_MAY_BE_NEEDED': 3
 };
+/**
+ * @enum {string}
+ */
+shaka.config.CodecSwitchingStrategy = {
+  RELOAD: 'reload',
+  SMOOTH: 'smooth'
+};
 /**
  * A utility to wrap abortable operations.  Note that these are not cancelable.
  * Cancelation implies undoing what has been done so far, whereas aborting only
@@ -1451,17 +1469,20 @@ shaka.util.AbortableOperation.prototype.promise;
  */
 shaka.net.NetworkingEngine = class extends shaka.util.FakeEventTarget {
   /**
-   * @param {function(number, number)=} onProgressUpdated Called when a progress
-   *   event is triggered. Passed the duration, in milliseconds, that the
-   *   request took, and the number of bytes transferred.
+   * @param {function(number, number, boolean)=} onProgressUpdated Called when
+   *   a progress event is triggered. Passed the duration, in milliseconds,
+   *   that the request took, the number of bytes transferred, and the boolean
+   *   of whether the switching is allowed.
    * @param {shaka.net.NetworkingEngine.OnHeadersReceived=} onHeadersReceived
    *   Called when the headers are received for a download.
    * @param {shaka.net.NetworkingEngine.OnDownloadFailed=} onDownloadFailed
    *   Called when a download fails, for any reason.
    * @param {shaka.net.NetworkingEngine.OnRequest=} onRequest
    *   Called when a request is made
+   * @param {shaka.net.NetworkingEngine.OnRetry=} onRetry
+   *   Called when a request retry is made
    */
-  constructor(onProgressUpdated, onHeadersReceived, onDownloadFailed, onRequest) {}
+  constructor(onProgressUpdated, onHeadersReceived, onDownloadFailed, onRequest, onRetry) {}
   /**
    * @param {boolean} forceHTTPS
    */
@@ -1590,7 +1611,8 @@ shaka.net.NetworkingEngine.RequestType = {
   'TIMING': 4,
   'SERVER_CERTIFICATE': 5,
   'KEY': 6,
-  'ADS': 7
+  'ADS': 7,
+  'CONTENT_STEERING': 8
 };
 /**
  * A more advanced form of the RequestType structure, meant to describe
@@ -1649,6 +1671,17 @@ shaka.net.NetworkingEngine.OnDownloadFailed;
  * A callback function called on every request
  */
 shaka.net.NetworkingEngine.OnRequest;
+/**
+ * @typedef {function(
+ *    !shaka.net.NetworkingEngine.RequestType,
+ *    (shaka.extern.RequestContext|undefined),
+ *    string,
+ *    string)}
+ * @description
+ * A callback function called on every request retry. The first string is the
+ * new URI and the second string is the old URI.
+ */
+shaka.net.NetworkingEngine.OnRetry;
 /**
  * @summary
  * An EventManager maintains a collection of "event
@@ -2100,8 +2133,10 @@ shaka.media.SegmentReference = class {
    *  not available.
    * @param {?shaka.extern.aes128Key=} aes128Key
    *  The segment's AES-128-CBC full segment encryption key and iv.
+   * @param {boolean=} allPartialSegments
+   *  Indicate if the segment has all partial segments
    */
-  constructor(startTime, endTime, uris, startByte, endByte, initSegmentReference, timestampOffset, appendWindowStart, appendWindowEnd, partialReferences, tilesLayout, tileDuration, syncTime, status, aes128Key) {}
+  constructor(startTime, endTime, uris, startByte, endByte, initSegmentReference, timestampOffset, appendWindowStart, appendWindowEnd, partialReferences, tilesLayout, tileDuration, syncTime, status, aes128Key, allPartialSegments) {}
   /**
    * Creates and returns the URIs of the resource containing the segment.
    * @return {!Array.<string>}
@@ -2168,6 +2203,24 @@ shaka.media.SegmentReference = class {
    * @return {boolean}
    */
   isIndependent() {}
+  /**
+   * Mark the reference as partial.
+   */
+  markAsPartial() {}
+  /**
+   * Returns true if the segment is partial.
+   * @return {boolean}
+   */
+  isPartial() {}
+  /**
+   * Mark the reference as being the last part of the full segment
+   */
+  markAsLastPartial() {}
+  /**
+   * Returns true if reference as being the last part of the full segment.
+   * @return {boolean}
+   */
+  isLastPartial() {}
   /**
    * Mark the reference as byterange optimization.
    * The "byterange optimization" means that it is playable using MP4 low
@@ -2291,11 +2344,10 @@ shaka.util.TsParser = class {
    * The code is based on hls.js
    * Credit to https://github.com/video-dev/hls.js/blob/master/src/demux/tsdemuxer.ts
    * @param {shaka.extern.MPEG_PES} pes
-   * @param {?shaka.extern.MPEG_PES=} nextPes
    * @param {?shaka.extern.VideoNalu=} lastNalu
    * @return {!Array.<shaka.extern.VideoNalu>}
    */
-  parseNalus(pes, nextPes, lastNalu) {}
+  parseNalus(pes, lastNalu) {}
   /**
    * Return the ID3 metadata
    * @return {!Array.<shaka.extern.ID3Metadata>}
@@ -2308,14 +2360,16 @@ shaka.util.TsParser = class {
   getAudioData() {}
   /**
    * Return the audio data
+   * @param {boolean=} naluProcessing
    * @return {!Array.<shaka.extern.MPEG_PES>}
    */
-  getVideoData() {}
+  getVideoData(naluProcessing) {}
   /**
    * Return the start time for the audio and video
-   * @return {{audio: ?number, video: ?number}}
+   * @param {string} contentType
+   * @return {?number}
    */
-  getStartTime() {}
+  getStartTime(contentType) {}
   /**
    * Return the audio and video codecs
    * @return {{audio: ?string, video: ?string}}
@@ -2567,7 +2621,9 @@ shaka.media.PresentationTimeline = class {
  * @typedef {{
  *   start: number,
  *   unscaledStart: number,
- *   end: number
+ *   end: number,
+ *   partialSegments: number,
+ *   segmentPosition: number
  * }}
  * @description
  * Defines a time range of a media segment.  Times are in seconds.
@@ -2577,6 +2633,10 @@ shaka.media.PresentationTimeline = class {
  *   The start time of the range in representation timescale units.
  * @property {number} end
  *   The end time (exclusive) of the range.
+ * @property {number} partialSegments
+ *   The number of partial segments
+ * @property {number} segmentPosition
+ *   The segment position of the timeline entry as it appears in the manifest
  */
 shaka.media.PresentationTimeline.TimeRange;
 /**
@@ -2796,6 +2856,32 @@ shaka.text.SimpleTextDisplayer = class {
    */
   setTextVisibility(on) {}
 };
+/**
+* A stub text displayer plugin that does nothing
+* @implements {shaka.extern.TextDisplayer}
+*/
+shaka.text.StubTextDisplayer = class {
+  /**
+   * @override
+   */
+  remove(start, end) {}
+  /**
+   * @override
+   */
+  append(cues) {}
+  /**
+   * @override
+   */
+  destroy() {}
+  /**
+   * @override
+   */
+  isTextVisible() {}
+  /**
+   * @override
+   */
+  setTextVisibility(on) {}
+};
 /**  */
 shaka.util.Dom = class {
   /**
@@ -3043,16 +3129,9 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    */
   static probeSupport(promptsOkay) {}
   /**
-   * Tell the player to use <code>mediaElement</code> for all <code>load</code>
-   * requests until <code>detach</code> or <code>destroy</code> are called.
-   * <p>
-   * Calling <code>attach</code> with <code>initializedMediaSource=true</code>
-   * will tell the player to take the initial load step and initialize media
-   * source.
-   * <p>
-   * Calls to <code>attach</code> will interrupt any in-progress calls to
-   * <code>load</code> but cannot interrupt calls to <code>attach</code>,
-   * <code>detach</code>, or <code>unload</code>.
+   * Attaches the player to a media element.
+   * If the player was already attached to a media element, first detaches from
+   * that media element.
    * @param {!HTMLMediaElement} mediaElement
    * @param {boolean=} initializeMediaSource
    * @return {!Promise}
@@ -3065,35 +3144,15 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    */
   attachCanvas(canvas) {}
   /**
-   * Tell the player to stop using its current media element. If the player is:
-   * <ul>
-   *  <li>detached, this will do nothing,
-   *  <li>attached, this will release the media element,
-   *  <li>loading, this will abort loading, unload, and release the media
-   *      element,
-   *  <li>playing content, this will stop playback, unload, and release the
-   *      media element.
-   * </ul>
-   * <p>
-   * Calls to <code>detach</code> will interrupt any in-progress calls to
-   * <code>load</code> but cannot interrupt calls to <code>attach</code>,
-   * <code>detach</code>, or <code>unload</code>.
+   * Detach the player from the current media element. Leaves the player in a
+   * state where it cannot play media, until it has been attached to something
+   * else.
+   * @param {boolean=} keepAdManager
    * @return {!Promise}
    */
-  detach() {}
+  detach(keepAdManager) {}
   /**
-   * Tell the player to either return to:
-   * <ul>
-   *   <li>detached (when it does not have a media element),
-   *   <li>attached (when it has a media element and
-   *     <code>initializedMediaSource=false</code>)
-   *   <li>media source initialized (when it has a media element and
-   *     <code>initializedMediaSource=true</code>)
-   * </ul>
-   * <p>
-   * Calls to <code>unload</code> will interrupt any in-progress calls to
-   * <code>load</code> but cannot interrupt calls to <code>attach</code>,
-   * <code>detach</code>, or <code>unload</code>.
+   * Unloads the currently playing stream, if any.
    * @param {boolean=} initializeMediaSource
    * @param {boolean=} keepAdManager
    * @return {!Promise}
@@ -3108,22 +3167,21 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    */
   updateStartTime(startTime) {}
   /**
-   * Tell the player to load the content at <code>assetUri</code> and start
-   * playback at <code>startTime</code>. Before calling <code>load</code>,
-   * a call to <code>attach</code> must have succeeded.
-   * <p>
-   * Calls to <code>load</code> will interrupt any in-progress calls to
-   * <code>load</code> but cannot interrupt calls to <code>attach</code>,
-   * <code>detach</code>, or <code>unload</code>.
+   * Loads a new stream.
+   * If another stream was already playing, first unloads that stream.
    * @param {string} assetUri
    * @param {?number=} startTime
    *    When <code>startTime</code> is <code>null</code> or
    *    <code>undefined</code>, playback will start at the default start time (0
    *    for VOD and liveEdge for LIVE).
-   * @param {string=} mimeType
+   * @param {?string=} mimeType
    * @return {!Promise}
    */
   load(assetUri, startTime, mimeType) {}
+  /**
+   * Releases all of the mutexes of the player. Meant for use by the tests.
+   */
+  releaseAllMutexes() {}
   /**
    * Changes configuration settings on the Player.  This checks the names of
    * keys and the types of values to avoid coding errors.  If there are errors,
@@ -3222,7 +3280,8 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
   isAudioOnly() {}
   /**
    * Get the range of time (in seconds) that seeking is allowed. If the player
-   * has not loaded content, this will return a range from 0 to 0.
+   * has not loaded content and the manifest is HLS, this will return a range
+   * from 0 to 0.
    * @return {{start: number, end: number}}
    */
   seekRange() {}
@@ -3320,6 +3379,13 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    * @return {!Array.<shaka.extern.Track>}
    */
   getImageTracks() {}
+  /**
+   * Returns Thumbnail objects for each thumbnail for a given image track ID.
+   * If the player has not loaded content, this will return a null.
+   * @param {number} trackId
+   * @return {!Promise.<?Array<!shaka.extern.Thumbnail>>}
+   */
+  getAllThumbnails(trackId) {}
   /**
    * Return a Thumbnail object from a image track Id and time.
    * If the player has not loaded content, this will return a null.
@@ -4444,6 +4510,14 @@ shaka.dash.DashParser = class {
    * @override
    */
   onExpirationUpdated(sessionId, expiration) {}
+  /**
+   * @override
+   */
+  onInitialVariantChosen(variant) {}
+  /**
+   * @override
+   */
+  banLocation(uri) {}
 };
 /**
  */
@@ -4513,6 +4587,14 @@ shaka.hls.HlsParser = class {
    * @override
    */
   onExpirationUpdated(sessionId, expiration) {}
+  /**
+   * @override
+   */
+  onInitialVariantChosen(variant) {}
+  /**
+   * @override
+   */
+  banLocation(uri) {}
 };
 /**
  * Creates a new MSS parser.
@@ -4541,6 +4623,14 @@ shaka.mss.MssParser = class {
    * @override
    */
   onExpirationUpdated(sessionId, expiration) {}
+  /**
+   * @override
+   */
+  onInitialVariantChosen(variant) {}
+  /**
+   * @override
+   */
+  banLocation(uri) {}
 };
 /**
  * @summary A networking plugin to handle http and https URIs via the Fetch API.
@@ -5013,7 +5103,7 @@ shaka.text.TtmlTextParser = class {
   /**
    * @override
    */
-  parseMedia(data, time) {}
+  parseMedia(data, time, uri) {}
 };
 /**
  * @implements {shaka.extern.TextParser}
@@ -5036,7 +5126,7 @@ shaka.text.Mp4TtmlParser = class {
   /**
    * @override
    */
-  parseMedia(data, time) {}
+  parseMedia(data, time, uri) {}
 };
 /**
  * @implements {shaka.extern.TextParser}
@@ -5126,7 +5216,7 @@ shaka.text.SrtTextParser = class {
   /**
    * @override
    */
-  parseMedia(data, time) {}
+  parseMedia(data, time, uri) {}
   /**
    * Convert a SRT format to WebVTT
    * @param {string} data
@@ -5184,7 +5274,7 @@ shaka.transmuxer.AacTransmuxer = class {
   /**
    * @override
    */
-  getOrginalMimeType() {}
+  getOriginalMimeType() {}
   /**
    * @override
    */
@@ -5217,7 +5307,7 @@ shaka.transmuxer.Ac3Transmuxer = class {
   /**
    * @override
    */
-  getOrginalMimeType() {}
+  getOriginalMimeType() {}
   /**
    * @override
    */
@@ -5250,7 +5340,7 @@ shaka.transmuxer.Ec3Transmuxer = class {
   /**
    * @override
    */
-  getOrginalMimeType() {}
+  getOriginalMimeType() {}
   /**
    * @override
    */
@@ -5283,7 +5373,7 @@ shaka.transmuxer.Mp3Transmuxer = class {
   /**
    * @override
    */
-  getOrginalMimeType() {}
+  getOriginalMimeType() {}
   /**
    * @override
    */
@@ -5316,7 +5406,7 @@ shaka.transmuxer.MpegTsTransmuxer = class {
   /**
    * @override
    */
-  getOrginalMimeType() {}
+  getOriginalMimeType() {}
   /**
    * @override
    */
@@ -5349,7 +5439,7 @@ shaka.transmuxer.MssTransmuxer = class {
   /**
    * @override
    */
-  getOrginalMimeType() {}
+  getOriginalMimeType() {}
   /**
    * @override
    */
@@ -5382,7 +5472,7 @@ shaka.transmuxer.TsTransmuxer = class {
   /**
    * @override
    */
-  getOrginalMimeType() {}
+  getOriginalMimeType() {}
   /**
    * @override
    */