Source: externs/shaka/player.js

  1. /*! @license
  2.  * Shaka Player
  3.  * Copyright 2016 Google LLC
  4.  * SPDX-License-Identifier: Apache-2.0
  5.  */
  8. /**
  9.  * @externs
  10.  */
  13. /**
  14.  * @typedef {{
  15.  *   timestamp: number,
  16.  *   id: number,
  17.  *   type: string,
  18.  *   fromAdaptation: boolean,
  19.  *   bandwidth: ?number
  20.  * }}
  21.  *
  22.  * @property {number} timestamp
  23.  *   The timestamp the choice was made, in seconds since 1970
  24.  *   (i.e. <code>Date.now() / 1000</code>).
  25.  * @property {number} id
  26.  *   The id of the track that was chosen.
  27.  * @property {string} type
  28.  *   The type of track chosen (<code>'variant'</code> or <code>'text'</code>).
  29.  * @property {boolean} fromAdaptation
  30.  *   <code>true</code> if the choice was made by AbrManager for adaptation;
  31.  *   <code>false</code> if it was made by the application through
  32.  *   <code>selectTrack</code>.
  33.  * @property {?number} bandwidth
  34.  *   The bandwidth of the chosen track (<code>null</code> for text).
  35.  * @exportDoc
  36.  */
  37. shaka.extern.TrackChoice;
  40. /**
  41.  * @typedef {{
  42.  *   timestamp: number,
  43.  *   state: string,
  44.  *   duration: number
  45.  * }}
  46.  *
  47.  * @property {number} timestamp
  48.  *   The timestamp the state was entered, in seconds since 1970
  49.  *   (i.e. <code>Date.now() / 1000</code>).
  50.  * @property {string} state
  51.  *   The state the player entered.  This could be <code>'buffering'</code>,
  52.  *   <code>'playing'</code>, <code>'paused'</code>, or <code>'ended'</code>.
  53.  * @property {number} duration
  54.  *   The number of seconds the player was in this state.  If this is the last
  55.  *   entry in the list, the player is still in this state, so the duration will
  56.  *   continue to increase.
  57.  * @exportDoc
  58.  */
  59. shaka.extern.StateChange;
  62. /**
  63.  * @typedef {{
  64.  *   width: number,
  65.  *   height: number,
  66.  *   streamBandwidth: number,
  67.  *   currentCodecs: string,
  68.  *
  69.  *   decodedFrames: number,
  70.  *   droppedFrames: number,
  71.  *   corruptedFrames: number,
  72.  *   estimatedBandwidth: number,
  73.  *
  74.  *   completionPercent: number,
  75.  *   loadLatency: number,
  76.  *   manifestTimeSeconds: number,
  77.  *   drmTimeSeconds: number,
  78.  *   playTime: number,
  79.  *   pauseTime: number,
  80.  *   bufferingTime: number,
  81.  *   licenseTime: number,
  82.  *   liveLatency: number,
  83.  *
  84.  *   maxSegmentDuration: number,
  85.  *
  86.  *   gapsJumped: number,
  87.  *   stallsDetected: number,
  88.  *
  89.  *   manifestSizeBytes: number,
  90.  *   bytesDownloaded: number,
  91.  *
  92.  *   nonFatalErrorCount: number,
  93.  *   manifestPeriodCount: number,
  94.  *   manifestGapCount: number,
  95.  *
  96.  *   switchHistory: !Array<shaka.extern.TrackChoice>,
  97.  *   stateHistory: !Array<shaka.extern.StateChange>
  98.  * }}
  99.  *
  100.  * @description
  101.  * Contains statistics and information about the current state of the player.
  102.  * This is meant for applications that want to log quality-of-experience (QoE)
  103.  * or other stats.  These values will reset when <code>load()</code> is called
  104.  * again.
  105.  *
  106.  * @property {number} width
  107.  *   The width of the current video track. If nothing is loaded or the content
  108.  *   is audio-only, NaN.
  109.  * @property {number} height
  110.  *   The height of the current video track. If nothing is loaded or the content
  111.  *   is audio-only, NaN.
  112.  * @property {number} streamBandwidth
  113.  *   The bandwidth required for the current streams (total, in bit/sec).
  114.  *   It takes into account the playbackrate. If nothing is loaded, NaN.
  115.  * @property {string} currentCodecs
  116.  *   The current codec of the current streams.
  117.  *
  118.  * @property {number} decodedFrames
  119.  *   The total number of frames decoded by the Player. If not reported by the
  120.  *   browser, NaN.
  121.  * @property {number} droppedFrames
  122.  *   The total number of frames dropped by the Player. If not reported by the
  123.  *   browser, NaN.
  124.  * @property {number} corruptedFrames
  125.  *   The total number of corrupted frames dropped by the browser. If not
  126.  *   reported by the browser, NaN.
  127.  * @property {number} estimatedBandwidth
  128.  *   The current estimated network bandwidth (in bit/sec). If no estimate
  129.  *   available, NaN.
  130.  *
  131.  * @property {number} gapsJumped
  132.  *   The total number of playback gaps jumped by the GapJumpingController.
  133.  *   If nothing is loaded, NaN.
  134.  * @property {number} stallsDetected
  135.  *   The total number of playback stalls detected by the StallDetector.
  136.  *   If nothing is loaded, NaN.
  137.  *
  138.  * @property {number} completionPercent
  139.  *   This is the greatest completion percent that the user has experienced in
  140.  *   playback. Also known as the "high water mark". If nothing is loaded, or
  141.  *   the stream is live (and therefore indefinite), NaN.
  142.  * @property {number} loadLatency
  143.  *   This is the number of seconds it took for the video element to have enough
  144.  *   data to begin playback.  This is measured from the time load() is called to
  145.  *   the time the <code>'loadeddata'</code> event is fired by the media element.
  146.  *   If nothing is loaded, NaN.
  147.  * @property {number} manifestTimeSeconds
  148.  *   The amount of time it took to download and parse the manifest.
  149.  *   If nothing is loaded, NaN.
  150.  * @property {number} drmTimeSeconds
  151.  *   The amount of time it took to download the first drm key, and load that key
  152.  *   into the drm system. If nothing is loaded or DRM is not in use, NaN.
  153.  * @property {number} playTime
  154.  *   The total time spent in a playing state in seconds. If nothing is loaded,
  155.  *   NaN.
  156.  * @property {number} pauseTime
  157.  *   The total time spent in a paused state in seconds. If nothing is loaded,
  158.  *   NaN.
  159.  * @property {number} bufferingTime
  160.  *   The total time spent in a buffering state in seconds. If nothing is
  161.  *   loaded, NaN.
  162.  * @property {number} licenseTime
  163.  *   The time spent on license requests during this session in seconds. If DRM
  164.  *   is not in use, NaN.
  165.  * @property {number} liveLatency
  166.  *   The time between the capturing of a frame and the end user having it
  167.  *   displayed on their screen. If nothing is loaded or the content is VOD,
  168.  *   NaN.
  169.  *
  170.  * @property {number} maxSegmentDuration
  171.  *   The presentation's max segment duration in seconds. If nothing is loaded,
  172.  *   NaN.
  173.  *
  174.  * @property {number} manifestSizeBytes
  175.  *   Size of the manifest payload. For DASH & MSS it will match the latest
  176.  *   downloaded manifest. For HLS, it will match the lastly downloaded playlist.
  177.  *   If nothing is loaded or in src= mode, NaN.
  178.  * @property {number} bytesDownloaded
  179.  *   The bytes downloaded during the playback. If nothing is loaded, NaN.
  180.  *
  181.  * @property {number} nonFatalErrorCount
  182.  *   The amount of non fatal errors that occurred.  If nothing is loaded, NaN.
  183.  * @property {number} manifestPeriodCount
  184.  *   The amount of periods occurred in the manifest. For DASH it represents
  185.  *   number of Period elements in a manifest. For HLS & MSS it is always 1.
  186.  *   In src= mode or if nothing is loaded, NaN.
  187.  * @property {number} manifestGapCount
  188.  *   The amount of gaps found in a manifest. For DASH, it represents number of
  189.  *   discontinuities found between periods. For HLS, it is a number of EXT-X-GAP
  190.  *   and GAP=YES occurrences. For MSS, it is always set to 0.
  191.  *   If in src= mode or nothing is loaded, NaN.
  192.  *
  193.  * @property {!Array<shaka.extern.TrackChoice>} switchHistory
  194.  *   A history of the stream changes.
  195.  * @property {!Array<shaka.extern.StateChange>} stateHistory
  196.  *   A history of the state changes.
  197.  * @exportDoc
  198.  */
  199. shaka.extern.Stats;
  202. /**
  203.  * @typedef {{
  204.  *   start: number,
  205.  *   end: number
  206.  * }}
  207.  *
  208.  * @description
  209.  * Contains the times of a range of buffered content.
  210.  *
  211.  * @property {number} start
  212.  *   The start time of the range, in seconds.
  213.  * @property {number} end
  214.  *   The end time of the range, in seconds.
  215.  * @exportDoc
  216.  */
  217. shaka.extern.BufferedRange;
  220. /**
  221.  * @typedef {{
  222.  *   total: !Array<shaka.extern.BufferedRange>,
  223.  *   audio: !Array<shaka.extern.BufferedRange>,
  224.  *   video: !Array<shaka.extern.BufferedRange>,
  225.  *   text: !Array<shaka.extern.BufferedRange>
  226.  * }}
  227.  *
  228.  * @description
  229.  * Contains information about the current buffered ranges.
  230.  *
  231.  * @property {!Array<shaka.extern.BufferedRange>} total
  232.  *   The combined audio/video buffered ranges, reported by
  233.  *   <code>video.buffered</code>.
  234.  * @property {!Array<shaka.extern.BufferedRange>} audio
  235.  *   The buffered ranges for audio content.
  236.  * @property {!Array<shaka.extern.BufferedRange>} video
  237.  *   The buffered ranges for video content.
  238.  * @property {!Array<shaka.extern.BufferedRange>} text
  239.  *   The buffered ranges for text content.
  240.  * @exportDoc
  241.  */
  242. shaka.extern.BufferedInfo;
  245. /**
  246.  * @typedef {{
  247.  *   id: number,
  248.  *   active: boolean,
  249.  *
  250.  *   type: string,
  251.  *   bandwidth: number,
  252.  *
  253.  *   language: string,
  254.  *   label: ?string,
  255.  *   kind: ?string,
  256.  *   width: ?number,
  257.  *   height: ?number,
  258.  *   frameRate: ?number,
  259.  *   pixelAspectRatio: ?string,
  260.  *   hdr: ?string,
  261.  *   colorGamut: ?string,
  262.  *   videoLayout: ?string,
  263.  *   mimeType: ?string,
  264.  *   audioMimeType: ?string,
  265.  *   videoMimeType: ?string,
  266.  *   codecs: ?string,
  267.  *   audioCodec: ?string,
  268.  *   videoCodec: ?string,
  269.  *   primary: boolean,
  270.  *   roles: !Array<string>,
  271.  *   audioRoles: Array<string>,
  272.  *   accessibilityPurpose: ?shaka.media.ManifestParser.AccessibilityPurpose,
  273.  *   forced: boolean,
  274.  *   videoId: ?number,
  275.  *   audioId: ?number,
  276.  *   audioGroupId: ?string,
  277.  *   channelsCount: ?number,
  278.  *   audioSamplingRate: ?number,
  279.  *   tilesLayout: ?string,
  280.  *   audioBandwidth: ?number,
  281.  *   videoBandwidth: ?number,
  282.  *   spatialAudio: boolean,
  283.  *   originalVideoId: ?string,
  284.  *   originalAudioId: ?string,
  285.  *   originalTextId: ?string,
  286.  *   originalImageId: ?string,
  287.  *   originalLanguage: ?string
  288.  * }}
  289.  *
  290.  * @description
  291.  * An object describing a media track.  This object should be treated as
  292.  * read-only as changing any values does not have any effect.  This is the
  293.  * public view of an audio/video paring (variant type).
  294.  *
  295.  * @property {number} id
  296.  *   The unique ID of the track.
  297.  * @property {boolean} active
  298.  *   If true, this is the track being streamed (another track may be
  299.  *   visible/audible in the buffer).
  300.  *
  301.  * @property {string} type
  302.  *   The type of track, either <code>'variant'</code> or <code>'text'</code>
  303.  *   or <code>'image'</code>.
  304.  * @property {number} bandwidth
  305.  *   The bandwidth required to play the track, in bits/sec.
  306.  *
  307.  * @property {string} language
  308.  *   The language of the track, or <code>'und'</code> if not given.  This value
  309.  *   is normalized as follows - language part is always lowercase and translated
  310.  *   to ISO-639-1 when possible, locale part is always uppercase,
  311.  *   i.e. <code>'en-US'</code>.
  312.  * @property {?string} label
  313.  *   The track label, which is unique text that should describe the track.
  314.  * @property {?string} kind
  315.  *   (only for text tracks) The kind of text track, either
  316.  *   <code>'caption'</code> or <code>'subtitle'</code>.
  317.  * @property {?number} width
  318.  *   The video width provided in the manifest, if present.
  319.  * @property {?number} height
  320.  *   The video height provided in the manifest, if present.
  321.  * @property {?number} frameRate
  322.  *   The video framerate provided in the manifest, if present.
  323.  * @property {?string} pixelAspectRatio
  324.  *   The video pixel aspect ratio provided in the manifest, if present.
  325.  * @property {?string} hdr
  326.  *   The video HDR provided in the manifest, if present.
  327.  * @property {?string} colorGamut
  328.  *   The video color gamut provided in the manifest, if present.
  329.  * @property {?string} videoLayout
  330.  *   The video layout provided in the manifest, if present.
  331.  * @property {?string} mimeType
  332.  *   The MIME type of the content provided in the manifest.
  333.  * @property {?string} audioMimeType
  334.  *   The audio MIME type of the content provided in the manifest.
  335.  * @property {?string} videoMimeType
  336.  *   The video MIME type of the content provided in the manifest.
  337.  * @property {?string} codecs
  338.  *   The audio/video codecs string provided in the manifest, if present.
  339.  * @property {?string} audioCodec
  340.  *   The audio codecs string provided in the manifest, if present.
  341.  * @property {?string} videoCodec
  342.  *   The video codecs string provided in the manifest, if present.
  343.  * @property {boolean} primary
  344.  *   True indicates that this in the primary language for the content.
  345.  *   This flag is based on signals from the manifest.
  346.  *   This can be a useful hint about which language should be the default, and
  347.  *   indicates which track Shaka will use when the user's language preference
  348.  *   cannot be satisfied.
  349.  * @property {!Array<string>} roles
  350.  *   The roles of the track, e.g. <code>'main'</code>, <code>'caption'</code>,
  351.  *   or <code>'commentary'</code>.
  352.  * @property {Array<string>} audioRoles
  353.  *   The roles of the audio in the track, e.g. <code>'main'</code> or
  354.  *   <code>'commentary'</code>. Will be null for text tracks or variant tracks
  355.  *   without audio.
  356.  * @property {?shaka.media.ManifestParser.AccessibilityPurpose
  357.  *           } accessibilityPurpose
  358.  *   The DASH accessibility descriptor, if one was provided for this track.
  359.  *   For text tracks, this describes the text; otherwise, this is for the audio.
  360.  * @property {boolean} forced
  361.  *   True indicates that this in the forced text language for the content.
  362.  *   This flag is based on signals from the manifest.
  363.  * @property {?number} videoId
  364.  *   (only for variant tracks) The video stream id.
  365.  * @property {?number} audioId
  366.  *   (only for variant tracks) The audio stream id.
  367.  * @property {?string} audioGroupId
  368.  *   (only for variant tracks)
  369.  *   The ID of the stream's parent element. In DASH, this will be a unique
  370.  *   ID that represents the representation's parent adaptation element
  371.  * @property {?number} channelsCount
  372.  *   The count of the audio track channels.
  373.  * @property {?number} audioSamplingRate
  374.  *   Specifies the maximum sampling rate of the content.
  375.  * @property {?string} tilesLayout
  376.  *   The value is a grid-item-dimension consisting of two positive decimal
  377.  *   integers in the format: column-x-row ('4x3'). It describes the arrangement
  378.  *   of Images in a Grid. The minimum valid LAYOUT is '1x1'.
  379.  * @property {boolean} spatialAudio
  380.  *   True indicates that the content has spatial audio.
  381.  *   This flag is based on signals from the manifest.
  382.  * @property {?number} audioBandwidth
  383.  *   (only for variant tracks) The audio stream's bandwidth if known.
  384.  * @property {?number} videoBandwidth
  385.  *   (only for variant tracks) The video stream's bandwidth if known.
  386.  * @property {?string} originalVideoId
  387.  *   (variant tracks only) The original ID of the video part of the track, if
  388.  *   any, as it appeared in the original manifest.
  389.  * @property {?string} originalAudioId
  390.  *   (variant tracks only) The original ID of the audio part of the track, if
  391.  *   any, as it appeared in the original manifest.
  392.  * @property {?string} originalTextId
  393.  *   (text tracks only) The original ID of the text track, if any, as it
  394.  *   appeared in the original manifest.
  395.  * @property {?string} originalImageId
  396.  *   (image tracks only) The original ID of the image track, if any, as it
  397.  *   appeared in the original manifest.
  398.  * @property {?string} originalLanguage
  399.  *   The original language of the track, if any, as it appeared in the original
  400.  *   manifest.  This is the exact value provided in the manifest; for normalized
  401.  *   value use <code>language</code> property.
  402.  * @exportDoc
  403.  */
  404. shaka.extern.Track;
  406. /**
  407.  * @typedef {{
  408.  *   active: boolean,
  409.  *   language: string,
  410.  *   label: ?string,
  411.  *   mimeType: ?string,
  412.  *   codecs: ?string,
  413.  *   primary: boolean,
  414.  *   roles: !Array<string>,
  415.  *   accessibilityPurpose: ?shaka.media.ManifestParser.AccessibilityPurpose,
  416.  *   channelsCount: ?number,
  417.  *   audioSamplingRate: ?number,
  418.  *   spatialAudio: boolean,
  419.  *   originalLanguage: ?string
  420.  * }}
  421.  *
  422.  * @description
  423.  * An object describing a audio track.  This object should be treated as
  424.  * read-only as changing any values does not have any effect.
  425.  *
  426.  * @property {boolean} active
  427.  *   If true, this is the track being streamed (another track may be
  428.  *   visible/audible in the buffer).
  429.  *
  430.  * @property {string} language
  431.  *   The language of the track, or <code>'und'</code> if not given.  This value
  432.  *   is normalized as follows - language part is always lowercase and translated
  433.  *   to ISO-639-1 when possible, locale part is always uppercase,
  434.  *   i.e. <code>'en-US'</code>.
  435.  * @property {?string} label
  436.  *   The track label, which is unique text that should describe the track.
  437.  * @property {?string} mimeType
  438.  *   The MIME type of the content provided in the manifest.
  439.  * @property {?string} codecs
  440.  *   The audio codecs string provided in the manifest, if present.
  441.  * @property {boolean} primary
  442.  *   True indicates that this in the primary language for the content.
  443.  *   This flag is based on signals from the manifest.
  444.  *   This can be a useful hint about which language should be the default, and
  445.  *   indicates which track Shaka will use when the user's language preference
  446.  *   cannot be satisfied.
  447.  * @property {!Array<string>} roles
  448.  *   The roles of the track, e.g. <code>'main'</code>, <code>'caption'</code>,
  449.  *   or <code>'commentary'</code>.
  450.  * @property {?shaka.media.ManifestParser.AccessibilityPurpose
  451.  *           } accessibilityPurpose
  452.  *   The DASH accessibility descriptor, if one was provided for this track.
  453.  * @property {?number} channelsCount
  454.  *   The count of the audio track channels.
  455.  * @property {?number} audioSamplingRate
  456.  *   Specifies the maximum sampling rate of the content.
  457.  * @property {boolean} spatialAudio
  458.  *   True indicates that the content has spatial audio.
  459.  *   This flag is based on signals from the manifest.
  460.  * @property {?string} originalLanguage
  461.  *   The original language of the track, if any, as it appeared in the original
  462.  *   manifest.  This is the exact value provided in the manifest; for normalized
  463.  *   value use <code>language</code> property.
  464.  * @exportDoc
  465.  */
  466. shaka.extern.AudioTrack;
  469. /**
  470.  * @typedef {{
  471.  *   id: number,
  472.  *   active: boolean,
  473.  *   type: string,
  474.  *   bandwidth: number,
  475.  *   language: string,
  476.  *   label: ?string,
  477.  *   kind: ?string,
  478.  *   mimeType: ?string,
  479.  *   codecs: ?string,
  480.  *   primary: boolean,
  481.  *   roles: !Array<string>,
  482.  *   accessibilityPurpose: ?shaka.media.ManifestParser.AccessibilityPurpose,
  483.  *   forced: boolean,
  484.  *   originalTextId: ?string,
  485.  *   originalLanguage: ?string
  486.  * }}
  487.  *
  488.  * @description
  489.  * An object describing a text track.  This object should be treated as
  490.  * read-only as changing any values does not have any effect.
  491.  *
  492.  * @property {number} id
  493.  *   The unique ID of the track.
  494.  * @property {boolean} active
  495.  *   If true, this is the track being streamed (another track may be
  496.  *   visible in the buffer).
  497.  * @property {string} type
  498.  *   The type of track, either <code>'variant'</code> or <code>'text'</code>
  499.  *   or <code>'image'</code>.
  500.  * @property {number} bandwidth
  501.  *   The bandwidth required to play the track, in bits/sec.
  502.  * @property {string} language
  503.  *   The language of the track, or <code>'und'</code> if not given.  This value
  504.  *   is normalized as follows - language part is always lowercase and translated
  505.  *   to ISO-639-1 when possible, locale part is always uppercase,
  506.  *   i.e. <code>'en-US'</code>.
  507.  * @property {?string} label
  508.  *   The track label, which is unique text that should describe the track.
  509.  * @property {?string} kind
  510.  *   The kind of text track, either <code>'caption'</code> or
  511.  *  <code>'subtitle'</code>.
  512.  * @property {?string} mimeType
  513.  *   The MIME type of the content provided in the manifest.
  514.  * @property {?string} codecs
  515.  *   The codecs string provided in the manifest, if present.
  516.  * @property {boolean} primary
  517.  *   True indicates that this in the primary language for the content.
  518.  *   This flag is based on signals from the manifest.
  519.  *   This can be a useful hint about which language should be the default, and
  520.  *   indicates which track Shaka will use when the user's language preference
  521.  *   cannot be satisfied.
  522.  * @property {!Array<string>} roles
  523.  *   The roles of the track, e.g. <code>'main'</code>, <code>'caption'</code>,
  524.  *   or <code>'commentary'</code>.
  525.  * @property {?shaka.media.ManifestParser.AccessibilityPurpose
  526.  *           } accessibilityPurpose
  527.  *   The DASH accessibility descriptor, if one was provided for this track.
  528.  * @property {boolean} forced
  529.  *   True indicates that this in the forced text language for the content.
  530.  *   This flag is based on signals from the manifest.
  531.  * @property {?string} originalTextId
  532.  *   The original ID of the text track, if any, as it
  533.  *   appeared in the original manifest.
  534.  * @property {?string} originalLanguage
  535.  *   The original language of the track, if any, as it appeared in the original
  536.  *   manifest.  This is the exact value provided in the manifest; for normalized
  537.  *   value use <code>language</code> property.
  538.  * @exportDoc
  539.  */
  540. shaka.extern.TextTrack;
  543. /**
  544.  * @typedef {{
  545.  *   active: boolean,
  546.  *   bandwidth: number,
  547.  *   width: ?number,
  548.  *   height: ?number,
  549.  *   frameRate: ?number,
  550.  *   pixelAspectRatio: ?string,
  551.  *   hdr: ?string,
  552.  *   colorGamut: ?string,
  553.  *   videoLayout: ?string,
  554.  *   mimeType: ?string,
  555.  *   codecs: ?string
  556.  * }}
  557.  *
  558.  * @description
  559.  * An object describing a video track.  This object should be treated as
  560.  * read-only as changing any values does not have any effect.
  561.  *
  562.  * @property {boolean} active
  563.  *   If true, this is the track being streamed (another track may be
  564.  *   visible/audible in the buffer).
  565.  * @property {number} bandwidth
  566.  *   The bandwidth required to play the track, in bits/sec.
  567.  * @property {?number} width
  568.  *   The video width provided in the manifest, if present.
  569.  * @property {?number} height
  570.  *   The video height provided in the manifest, if present.
  571.  * @property {?number} frameRate
  572.  *   The video framerate provided in the manifest, if present.
  573.  * @property {?string} pixelAspectRatio
  574.  *   The video pixel aspect ratio provided in the manifest, if present.
  575.  * @property {?string} hdr
  576.  *   The video HDR provided in the manifest, if present.
  577.  * @property {?string} colorGamut
  578.  *   The video color gamut provided in the manifest, if present.
  579.  * @property {?string} videoLayout
  580.  *   The video layout provided in the manifest, if present.
  581.  * @property {?string} mimeType
  582.  *   The video MIME type of the content provided in the manifest.
  583.  * @property {?string} codecs
  584.  *   The video codecs string provided in the manifest, if present.
  585.  * @exportDoc
  586.  */
  587. shaka.extern.VideoTrack;
  590. /**
  591.  * @typedef {{
  592.  *   id: number,
  593.  *   type: string,
  594.  *   bandwidth: number,
  595.  *   width: ?number,
  596.  *   height: ?number,
  597.  *   mimeType: ?string,
  598.  *   codecs: ?string,
  599.  *   tilesLayout: ?string,
  600.  *   originalImageId: ?string
  601.  * }}
  602.  *
  603.  * @description
  604.  * An object describing a image track.  This object should be treated as
  605.  * read-only as changing any values does not have any effect.
  606.  *
  607.  * @property {number} id
  608.  *   The unique ID of the track.
  609.  * @property {string} type
  610.  *   The type of track, either <code>'variant'</code> or <code>'text'</code>
  611.  *   or <code>'image'</code>.
  612.  * @property {number} bandwidth
  613.  *   The bandwidth required to play the track, in bits/sec.
  614.  * @property {?number} width
  615.  *   The width provided in the manifest, if present.
  616.  * @property {?number} height
  617.  *   The height provided in the manifest, if present.
  618.  * @property {?string} mimeType
  619.  *   The MIME type of the content provided in the manifest.
  620.  * @property {?string} codecs
  621.  *   The image codecs string provided in the manifest, if present.
  622.  * @property {?string} tilesLayout
  623.  *   The value is a grid-item-dimension consisting of two positive decimal
  624.  *   integers in the format: column-x-row ('4x3'). It describes the arrangement
  625.  *   of Images in a Grid. The minimum valid LAYOUT is '1x1'.
  626.  * @property {?string} originalImageId
  627.  *   The original ID of the image track, if any, as it appeared in the original
  628.  *   manifest.
  629.  * @exportDoc
  630.  */
  631. shaka.extern.ImageTrack;
  634. /**
  635.  * @typedef {!Array<!shaka.extern.Track>}
  636.  */
  637. shaka.extern.TrackList;
  640. /**
  641.  * @typedef {{
  642.  *   minWidth: number,
  643.  *   maxWidth: number,
  644.  *   minHeight: number,
  645.  *   maxHeight: number,
  646.  *   minPixels: number,
  647.  *   maxPixels: number,
  648.  *
  649.  *   minFrameRate: number,
  650.  *   maxFrameRate: number,
  651.  *
  652.  *   minBandwidth: number,
  653.  *   maxBandwidth: number,
  654.  *
  655.  *   minChannelsCount: number,
  656.  *   maxChannelsCount: number
  657.  * }}
  658.  *
  659.  * @description
  660.  * An object describing application restrictions on what tracks can play.  All
  661.  * restrictions must be fulfilled for a track to be playable/selectable.
  662.  * The restrictions system behaves somewhat differently at the ABR level and the
  663.  * player level, so please refer to the documentation for those specific
  664.  * settings.
  665.  *
  666.  * @see shaka.extern.PlayerConfiguration
  667.  * @see shaka.extern.AbrConfiguration
  668.  *
  669.  * @property {number} minWidth
  670.  *   The minimum width of a video track, in pixels.
  671.  *   <br>
  672.  *   Defaults to <code>0</code>.
  673.  * @property {number} maxWidth
  674.  *   The maximum width of a video track, in pixels.
  675.  *   <br>
  676.  *   Defaults to <code>Infinity</code>.
  677.  * @property {number} minHeight
  678.  *   The minimum height of a video track, in pixels.
  679.  *   <br>
  680.  *   Defaults to <code>0</code>.
  681.  * @property {number} maxHeight
  682.  *   The maximum height of a video track, in pixels.
  683.  *   <br>
  684.  *   Defaults to <code>Infinity</code>.
  685.  * @property {number} minPixels
  686.  *   The minimum number of total pixels in a video track (i.e.
  687.  *   <code>width * height</code>).
  688.  *   <br>
  689.  *   Defaults to <code>0</code>.
  690.  * @property {number} maxPixels
  691.  *   The maximum number of total pixels in a video track (i.e.
  692.  *   <code>width * height</code>).
  693.  *   <br>
  694.  *   Defaults to <code>Infinity</code>.
  695.  *
  696.  * @property {number} minFrameRate
  697.  *   The minimum framerate of a variant track.
  698.  *   <br>
  699.  *   Defaults to <code>0</code>.
  700.  * @property {number} maxFrameRate
  701.  *   The maximum framerate of a variant track.
  702.  *   <br>
  703.  *   Defaults to <code>Infinity</code>.
  704.  *
  705.  * @property {number} minBandwidth
  706.  *   The minimum bandwidth of a variant track, in bit/sec.
  707.  *   <br>
  708.  *   Defaults to <code>0</code>.
  709.  * @property {number} maxBandwidth
  710.  *   The maximum bandwidth of a variant track, in bit/sec.
  711.  *   <br>
  712.  *   Defaults to <code>Infinity</code>.
  713.  *
  714.  * @property {number} minChannelsCount
  715.  *   The minimum channels count of a variant track.
  716.  *   <br>
  717.  *   Defaults to <code>0</code>.
  718.  * @property {number} maxChannelsCount
  719.  *   The maximum channels count of a variant track.
  720.  *   <br>
  721.  *   Defaults to <code>Infinity</code>.
  722.  * @exportDoc
  723.  */
  724. shaka.extern.Restrictions;
  727. /**
  728.  * @typedef {{
  729.  *   persistentState: boolean,
  730.  *   encryptionSchemes: !Array<string|null>,
  731.  *   videoRobustnessLevels: !Array<string>,
  732.  *   audioRobustnessLevels: !Array<string>,
  733.  *   minHdcpVersions: !Array<string>
  734.  * }}
  735.  *
  736.  * @property {boolean} persistentState
  737.  *   Whether this key system supports persistent state.
  738.  * @property {!Array<string|null>} encryptionSchemes
  739.  *   An array of encryption schemes that are reported to work, through either
  740.  *   EME or MCap APIs. An empty array indicates that encryptionScheme queries
  741.  *   are not supported. This should not happen if our polyfills are installed.
  742.  * @property {!Array<string>} videoRobustnessLevels
  743.  *   An array of video robustness levels that are reported to work. An empty
  744.  *   array indicates that none were tested. Not all key systems have a list of
  745.  *   known robustness levels built into probeSupport().
  746.  * @property {!Array<string>} audioRobustnessLevels
  747.  *   An array of audio robustness levels that are reported to work. An empty
  748.  *   array indicates that none were tested. Not all key systems have a list of
  749.  *   known robustness levels built into probeSupport().
  750.  * @property {!Array<string>} minHdcpVersions
  751.  *   An array of min HDCP levels that are reported to work. An empty
  752.  *   array indicates that none were tested. Not all key systems have support to
  753.  *   check min HDCP levels.
  754.  * @exportDoc
  755.  */
  756. shaka.extern.DrmSupportType;
  759. /**
  760.  * @typedef {{
  761.  *   manifest: !Object<string, boolean>,
  762.  *   media: !Object<string, boolean>,
  763.  *   drm: !Object<string, ?shaka.extern.DrmSupportType>,
  764.  *   hardwareResolution: shaka.extern.Resolution
  765.  * }}
  766.  *
  767.  * @description
  768.  * An object detailing browser support for various features.
  769.  *
  770.  * @property {!Object<string, boolean>} manifest
  771.  *   A map of supported manifest types.
  772.  *   The keys are manifest MIME types and file extensions.
  773.  * @property {!Object<string, boolean>} media
  774.  *   A map of supported media types.
  775.  *   The keys are media MIME types.
  776.  * @property {!Object<string, ?shaka.extern.DrmSupportType>} drm
  777.  *   A map of supported key systems.
  778.  *   The keys are the key system names.  The value is <code>null</code> if it is
  779.  *   not supported.  Key systems not probed will not be in this dictionary.
  780.  * @property {shaka.extern.Resolution} hardwareResolution
  781.  *   The maximum detected hardware resolution, which may have
  782.  *   height==width==Infinity for devices without a maximum resolution or
  783.  *   without a way to detect the maximum.
  784.  *
  785.  * @exportDoc
  786.  */
  787. shaka.extern.SupportType;
  789. /**
  790.  * @typedef {{
  791.  *   cueTime: ?number,
  792.  *   data: !Uint8Array,
  793.  *   frames: !Array<shaka.extern.MetadataFrame>,
  794.  *   dts: ?number,
  795.  *   pts: ?number
  796.  * }}
  797.  *
  798.  * @description
  799.  * ID3 metadata in format defined by
  800.  * https://id3.org/id3v2.3.0#Declared_ID3v2_frames
  801.  * The content of the field.
  802.  *
  803.  * @property {?number} cueTime
  804.  * @property {!Uint8Array} data
  805.  * @property {!Array<shaka.extern.MetadataFrame>} frames
  806.  * @property {?number} dts
  807.  * @property {?number} pts
  808.  *
  809.  * @exportDoc
  810.  */
  811. shaka.extern.ID3Metadata;
  814. /**
  815.  * @typedef {{
  816.  *   type: string,
  817.  *   size: number,
  818.  *   data: Uint8Array
  819.  * }}
  820.  *
  821.  * @description metadata raw frame.
  822.  * @property {string} type
  823.  * @property {number} size
  824.  * @property {Uint8Array} data
  825.  * @exportDoc
  826.  */
  827. shaka.extern.MetadataRawFrame;
  830. /**
  831.  * @typedef {{
  832.  *   key: string,
  833.  *   data: (ArrayBuffer|string|number),
  834.  *   description: string,
  835.  *   mimeType: ?string,
  836.  *   pictureType: ?number
  837.  * }}
  838.  *
  839.  * @description metadata frame parsed.
  840.  * @property {string} key
  841.  * @property {ArrayBuffer|string|number} data
  842.  * @property {string} description
  843.  * @property {?string} mimeType
  844.  * @property {?number} pictureType
  845.  * @exportDoc
  846.  */
  847. shaka.extern.MetadataFrame;
  850. /**
  851.  * @typedef {{
  852.  *   video: ?shaka.extern.PlaybackStreamInfo,
  853.  *   audio: ?shaka.extern.PlaybackStreamInfo,
  854.  *   text: ?shaka.extern.PlaybackStreamInfo
  855.  * }}
  856.  *
  857.  * @description Represents the state of the current variant and text.
  858.  * @property {?shaka.extern.PlaybackStreamInfo} video
  859.  * @property {?shaka.extern.PlaybackStreamInfo} audio
  860.  * @property {?shaka.extern.PlaybackStreamInfo} text
  861.  * @exportDoc
  862.  */
  863. shaka.extern.PlaybackInfo;
  866. /**
  867.  * @typedef {{
  868.  *   codecs: string,
  869.  *   mimeType: string,
  870.  *   bandwidth: number,
  871.  *   width: ?number,
  872.  *   height: ?number
  873.  * }}
  874.  *
  875.  * @description Represents the state of the given stream.
  876.  * @property {string} codecs
  877.  * @property {string} mimeType
  878.  * @property {number} bandwidth
  879.  * @property {?number} width
  880.  * @property {?number} height
  881.  * @exportDoc
  882.  */
  883. shaka.extern.PlaybackStreamInfo;
  886. /**
  887.  * @typedef {{
  888.  *   startTime: number,
  889.  *   endTime: ?number,
  890.  *   values: !Array<shaka.extern.MetadataFrame>
  891.  * }}
  892.  *
  893.  * @property {number} startTime
  894.  * @property {?number} endTime
  895.  * @property {!Array<shaka.extern.MetadataFrame>} values
  896.  * @exportDoc
  897.  */
  898. shaka.extern.HLSInterstitial;
  901. /**
  902.  * @typedef {{
  903.  *   schemeIdUri: string,
  904.  *   value: string,
  905.  *   startTime: number,
  906.  *   endTime: number,
  907.  *   id: string,
  908.  *   timescale: number,
  909.  *   eventElement: Element,
  910.  *   eventNode: ?shaka.extern.xml.Node
  911.  * }}
  912.  *
  913.  * @description
  914.  * Contains information about a region of the timeline that will cause an event
  915.  * to be raised when the playhead enters or exits it.  In DASH this is the
  916.  * EventStream element.
  917.  *
  918.  * @property {string} schemeIdUri
  919.  *   Identifies the message scheme.
  920.  * @property {string} value
  921.  *   Specifies the value for the region.
  922.  * @property {number} startTime
  923.  *   The presentation time (in seconds) that the region should start.
  924.  * @property {number} endTime
  925.  *   The presentation time (in seconds) that the region should end.
  926.  * @property {string} id
  927.  *   Specifies an identifier for this instance of the region.
  928.  * @property {number} timescale
  929.  *   Provides the timescale, in ticks per second.
  930.  * @property {Element} eventElement
  931.  *   <b>DEPRECATED</b>: Use eventNode instead.
  932.  *   The XML element that defines the Event.
  933.  * @property {?shaka.extern.xml.Node} eventNode
  934.  *   The XML element that defines the Event.
  935.  * @exportDoc
  936.  */
  937. shaka.extern.TimelineRegionInfo;
  940. /**
  941.  * @typedef {{
  942.  *   schemeIdUri: string,
  943.  *   startTime: number,
  944.  *   endTime: number,
  945.  *   id: string,
  946.  *   emsg: shaka.extern.EmsgInfo
  947.  * }}
  948.  *
  949.  * @description
  950.  * Contains information about a region of the timeline that will cause an event
  951.  * to be raised when the playhead enters or exits it.
  952.  *
  953.  * @property {string} schemeIdUri
  954.  *   Identifies the metadata type.
  955.  * @property {number} startTime
  956.  *   The presentation time (in seconds) that the region should start.
  957.  * @property {number} endTime
  958.  *   The presentation time (in seconds) that the region should end.
  959.  * @property {string} id
  960.  *   Specifies an identifier for this instance of the region.
  961.  * @property {shaka.extern.EmsgInfo} emsg
  962.  *   Specifies the EMSG info.
  963.  * @exportDoc
  964.  */
  965. shaka.extern.EmsgTimelineRegionInfo;
  968. /**
  969.  * @typedef {{
  970.  *   schemeIdUri: string,
  971.  *   startTime: number,
  972.  *   endTime: number,
  973.  *   id: string,
  974.  *   payload: shaka.extern.MetadataFrame
  975.  * }}
  976.  *
  977.  * @description
  978.  * Contains information about a region of the timeline that will cause an event
  979.  * to be raised when the playhead enters or exits it.
  980.  *
  981.  * @property {string} schemeIdUri
  982.  *   Identifies the metadata type.
  983.  * @property {number} startTime
  984.  *   The presentation time (in seconds) that the region should start.
  985.  * @property {number} endTime
  986.  *   The presentation time (in seconds) that the region should end.
  987.  * @property {string} id
  988.  *   Specifies an identifier for this instance of the region.
  989.  * @property {shaka.extern.MetadataFrame} payload
  990.  *   Specifies the metadata frame.
  991.  * @exportDoc
  992.  */
  993. shaka.extern.MetadataTimelineRegionInfo;
  995. /**
  996.  * @typedef {{
  997.  *   audioSamplingRate: ?number,
  998.  *   bandwidth: number,
  999.  *   codecs: string,
  1000.  *   contentType: string,
  1001.  *   frameRate: ?number,
  1002.  *   height: ?number,
  1003.  *   mimeType: ?string,
  1004.  *   label: ?string,
  1005.  *   roles: ?Array<string>,
  1006.  *   language: ?string,
  1007.  *   channelsCount: ?number,
  1008.  *   pixelAspectRatio: ?string,
  1009.  *   width: ?number
  1010.  * }}
  1011.  *
  1012.  * @description
  1013.  * Contains information about the quality of an audio or video media stream.
  1014.  *
  1015.  * @property {?number} audioSamplingRate
  1016.  *   Specifies the maximum sampling rate of the content.
  1017.  * @property {number} bandwidth
  1018.  *   The bandwidth in bits per second.
  1019.  * @property {string} codecs
  1020.  *   The Stream's codecs, e.g., 'avc1.4d4015' or 'vp9', which must be
  1021.  * compatible with the Stream's MIME type.
  1022.  * @property {string} contentType
  1023.  *   The type of content, which may be "video" or "audio".
  1024.  * @property {?number} frameRate
  1025.  *   The video frame rate.
  1026.  * @property {?number} height
  1027.  *   The video height in pixels.
  1028.  * @property {string} mimeType
  1029.  *   The MIME type.
  1030.  * @property {?string} label
  1031.  *   The stream's label, when available.
  1032.  * @property {?Array<string>} roles
  1033.  *   The stream's role, when available.
  1034.  * @property {?string} language
  1035.  *   The stream's language, when available.
  1036.  * @property {?number} channelsCount
  1037.  *   The number of audio channels, or null if unknown.
  1038.  * @property {?string} pixelAspectRatio
  1039.  *   The pixel aspect ratio value; e.g. "1:1".
  1040.  * @property {?number} width
  1041.  *   The video width in pixels.
  1042.  * @exportDoc
  1043.  */
  1044. shaka.extern.MediaQualityInfo;
  1047. /**
  1048.  * @typedef {{
  1049.  *   schemeIdUri: string,
  1050.  *   value: string,
  1051.  *   startTime: number,
  1052.  *   endTime: number,
  1053.  *   timescale: number,
  1054.  *   presentationTimeDelta: number,
  1055.  *   eventDuration: number,
  1056.  *   id: number,
  1057.  *   messageData: Uint8Array
  1058.  * }}
  1059.  *
  1060.  * @description
  1061.  * Contains information about an EMSG MP4 box.
  1062.  *
  1063.  * @property {string} schemeIdUri
  1064.  *   Identifies the message scheme.
  1065.  * @property {string} value
  1066.  *   Specifies the value for the event.
  1067.  * @property {number} startTime
  1068.  *   The time that the event starts (in presentation time).
  1069.  * @property {number} endTime
  1070.  *   The time that the event ends (in presentation time).
  1071.  * @property {number} timescale
  1072.  *   Provides the timescale, in ticks per second.
  1073.  * @property {number} presentationTimeDelta
  1074.  *   The offset that the event starts, relative to the start of the segment
  1075.  *   this is contained in (in units of timescale).
  1076.  * @property {number} eventDuration
  1077.  *   The duration of the event (in units of timescale).
  1078.  * @property {number} id
  1079.  *   A field identifying this instance of the message.
  1080.  * @property {Uint8Array} messageData
  1081.  *   Body of the message.
  1082.  * @exportDoc
  1083.  */
  1084. shaka.extern.EmsgInfo;
  1087. /**
  1088.  * @typedef {{
  1089.  *   wallClockTime: number,
  1090.  *   programStartDate: Date
  1091.  * }}
  1092.  *
  1093.  * @description
  1094.  * Contains information about an PRFT MP4 box.
  1095.  *
  1096.  * @property {number} wallClockTime
  1097.  *   A UTC timestamp corresponding to decoding time in milliseconds.
  1098.  * @property {Date} programStartDate
  1099.  *   The derived start date of the program.
  1100.  * @exportDoc
  1101.  */
  1102. shaka.extern.ProducerReferenceTime;
  1105. /**
  1106.  * @typedef {{
  1107.  *   distinctiveIdentifierRequired: boolean,
  1108.  *   persistentStateRequired: boolean,
  1109.  *   videoRobustness: Array<string>,
  1110.  *   audioRobustness: Array<string>,
  1111.  *   serverCertificate: Uint8Array,
  1112.  *   serverCertificateUri: string,
  1113.  *   individualizationServer: string,
  1114.  *   sessionType: string,
  1115.  *   headers: !Object<string, string>
  1116.  * }}
  1117.  *
  1118.  * @property {boolean} distinctiveIdentifierRequired
  1119.  *   True if the application requires the key system to support distinctive
  1120.  *   identifiers.
  1121.  *   <br>
  1122.  *   Defaults to <code>false</code>.
  1123.  * @property {boolean} persistentStateRequired
  1124.  *   True if the application requires the key system to support persistent
  1125.  *   state, e.g., for persistent license storage.
  1126.  *   <br>
  1127.  *   Defaults to <code>false</code>.
  1128.  * @property {Array<string>} videoRobustness
  1129.  *   A key-system-specific Array of strings that specifies a required security
  1130.  *   level for video. For multiple robustness levels, list items in priority
  1131.  *   order.
  1132.  *   <br>
  1133.  *   Defaults to <code>[]</code>, i.e., no specific robustness required.
  1134.  * @property {Array<string>} audioRobustness
  1135.  *   A key-system-specific Array of strings that specifies a required security
  1136.  *   level for audio. For multiple robustness levels, list items in priority
  1137.  *   order.
  1138.  *   <br>
  1139.  *   Defaults to <code>[]</code>, i.e., no specific robustness required.
  1140.  * @property {Uint8Array} serverCertificate
  1141.  *   <i>An empty certificate (<code>byteLength==0</code>) will be treated as
  1142.  *   <code>null</code>.</i> <br>
  1143.  *   <i>A certificate will be requested from the license server if
  1144.  *   required.</i> <br>
  1145.  *   A key-system-specific server certificate used to encrypt license requests.
  1146.  *   Its use is optional and is meant as an optimization to avoid a round-trip
  1147.  *   to request a certificate.
  1148.  *   <br>
  1149.  *   Defaults to <code>null</code>.
  1150.  * @property {string} serverCertificateUri
  1151.  *   If given, will make a request to the given URI to get the server
  1152.  *   certificate. This is ignored if <code>serverCertificate</code> is set.
  1153.  *   <br>
  1154.  *   Defaults to <code>''</code>.
  1155.  * @property {string} individualizationServer
  1156.  *   The server that handles an <code>'individualization-request'</code>.
  1157.  *   If the server isn't given, it will default to the license server.
  1158.  *   <br>
  1159.  *   Defaults to <code>''</code>.
  1160.  * @property {string} sessionType
  1161.  *   The MediaKey session type to create streaming licenses with.  This doesn't
  1162.  *   affect offline storage.
  1163.  *   <br>
  1164.  *   Defaults to <code>'temporary'</code>.
  1165.  * @property {!Object<string, string>} headers
  1166.  *   The headers to use in the license request.
  1167.  *   <br>
  1168.  *   Defaults to <code>{}</code>.
  1169.  *
  1170.  * @exportDoc
  1171.  */
  1172. shaka.extern.AdvancedDrmConfiguration;
  1175. /**
  1176.  * @typedef {{
  1177.  *   sessionId: string,
  1178.  *   sessionType: string,
  1179.  *   initData: ?Uint8Array,
  1180.  *   initDataType: ?string
  1181.  * }}
  1182.  *
  1183.  * @description
  1184.  * DRM Session Metadata for an active session
  1185.  *
  1186.  * @property {string} sessionId
  1187.  *   Session id
  1188.  * @property {string} sessionType
  1189.  *   Session type
  1190.  * @property {?Uint8Array} initData
  1191.  *   Initialization data in the format indicated by initDataType.
  1192.  * @property {string} initDataType
  1193.  *   A string to indicate what format initData is in.
  1194.  * @exportDoc
  1195.  */
  1196. shaka.extern.DrmSessionMetadata;
  1199. /**
  1200.  * @typedef {{
  1201.  *   sessionId: string,
  1202.  *   initData: ?Uint8Array,
  1203.  *   initDataType: ?string
  1204.  * }}
  1205.  *
  1206.  * @description
  1207.  * DRM Session Metadata for saved persistent session
  1208.  *
  1209.  * @property {string} sessionId
  1210.  *   Session id
  1211.  * @property {?Uint8Array} initData
  1212.  *   Initialization data in the format indicated by initDataType.
  1213.  * @property {?string} initDataType
  1214.  *   A string to indicate what format initData is in.
  1215.  * @exportDoc
  1216.  */
  1217. shaka.extern.PersistentSessionMetadata;
  1220. /**
  1221.  * @typedef {{
  1222.  *   retryParameters: shaka.extern.RetryParameters,
  1223.  *   servers: !Object<string, string>,
  1224.  *   clearKeys: !Object<string, string>,
  1225.  *   delayLicenseRequestUntilPlayed: boolean,
  1226.  *   persistentSessionOnlinePlayback: boolean,
  1227.  *   persistentSessionsMetadata:
  1228.  *       !Array<shaka.extern.PersistentSessionMetadata>,
  1229.  *   advanced: Object<string, shaka.extern.AdvancedDrmConfiguration>,
  1230.  *   initDataTransform:(shaka.extern.InitDataTransform|undefined),
  1231.  *   logLicenseExchange: boolean,
  1232.  *   updateExpirationTime: number,
  1233.  *   preferredKeySystems: !Array<string>,
  1234.  *   keySystemsMapping: !Object<string, string>,
  1235.  *   parseInbandPsshEnabled: boolean,
  1236.  *   minHdcpVersion: string,
  1237.  *   ignoreDuplicateInitData: boolean,
  1238.  *   defaultAudioRobustnessForWidevine: string,
  1239.  *   defaultVideoRobustnessForWidevine: string
  1240.  * }}
  1241.  *
  1242.  * @property {shaka.extern.RetryParameters} retryParameters
  1243.  *   Retry parameters for license requests.
  1244.  * @property {!Object<string, string>} servers
  1245.  *   <i>Required for all but the clear key CDM.</i> <br>
  1246.  *   A dictionary which maps key system IDs to their license servers.
  1247.  *   For example,
  1248.  *   <code>{'com.widevine.alpha': 'https://example.com/drm'}</code>.
  1249.  *   <br>
  1250.  *   Defaults to <code>{}</code>.
  1251.  * @property {!Object<string, string>} clearKeys
  1252.  *   <i>Forces the use of the Clear Key CDM.</i>
  1253.  *   A map of key IDs (hex or base64) to keys (hex or base64).
  1254.  *   <br>
  1255.  *   Defaults to <code>{}</code>.
  1256.  * @property {boolean} delayLicenseRequestUntilPlayed
  1257.  *   True to configure drm to delay sending a license request until a user
  1258.  *   actually starts playing content.
  1259.  *   <br>
  1260.  *   Defaults to <code>false</code>.
  1261.  * @property {boolean} persistentSessionOnlinePlayback
  1262.  *   True to configure drm to try playback with given persistent session ids
  1263.  *   before requesting a license. Also prevents the session removal at playback
  1264.  *   stop, as-to be able to re-use it later.
  1265.  *   <br>
  1266.  *   Defaults to <code>false</code>.
  1267.  * @property {!Array<PersistentSessionMetadata>} persistentSessionsMetadata
  1268.  *   Persistent sessions metadata to load before starting playback.
  1269.  *   <br>
  1270.  *   Defaults to <code>[]</code>.
  1271.  * @property {Object<string, shaka.extern.AdvancedDrmConfiguration>} advanced
  1272.  *   <i>Optional.</i> <br>
  1273.  *   A dictionary which maps key system IDs to advanced DRM configuration for
  1274.  *   those key systems.
  1275.  *   <br>
  1276.  *   Defaults to <code>[]</code>.
  1277.  * @property {shaka.extern.InitDataTransform|undefined} initDataTransform
  1278.  *   <i>Optional.</i><br>
  1279.  *   If given, this function is called with the init data from the
  1280.  *   manifest/media and should return the (possibly transformed) init data to
  1281.  *   pass to the browser.
  1282.  * @property {boolean} logLicenseExchange
  1283.  *   <i>Optional.</i><br>
  1284.  *   If set to <code>true</code>, prints logs containing the license exchange.
  1285.  *   This includes the init data, request, and response data, printed as base64
  1286.  *   strings.  Don't use in production, for debugging only; has no affect in
  1287.  *   release builds as logging is removed.
  1288.  *   <br>
  1289.  *   Defaults to <code>false</code>.
  1290.  * @property {number} updateExpirationTime
  1291.  *   The frequency in seconds with which to check the expiration of a session.
  1292.  *   <br>
  1293.  *   Defaults to <code>1</code>.
  1294.  * @property {!Array<string>} preferredKeySystems
  1295.  *   Specifies the priorities of available DRM key systems.
  1296.  *   <br>
  1297.  *   Defaults <code>['com.microsoft.playready']</code> on Xbox One and
  1298.  *   PlayStation 4, and <code>[]</code> for all other browsers.
  1299.  * @property {Object<string, string>} keySystemsMapping
  1300.  *   A map of key system name to key system name.
  1301.  *   <br>
  1302.  *   Defaults to <code>{}</code>.
  1303.  * @property {boolean} parseInbandPsshEnabled
  1304.  *   When true parse DRM init data from pssh boxes in media and init segments
  1305.  *   and ignore 'encrypted' events.
  1306.  *   This is required when using in-band key rotation on Xbox One.
  1307.  *   <br>
  1308.  *   Defaults to <code>true</code> on Xbox One, and <code>false</code> for all
  1309.  *   other browsers.
  1310.  * @property {string} minHdcpVersion
  1311.  *   Indicates the minimum version of HDCP to start the playback of encrypted
  1312.  *   streams. <b>May be ignored if not supported by the device.</b>
  1313.  *   <br>
  1314.  *   Defaults to <code>''</code>, do not check the HDCP version.
  1315.  * @property {boolean} ignoreDuplicateInitData
  1316.  *   When true indicate that the player doesn't ignore duplicate init data.
  1317.  *   Note: Tizen 2015 and 2016 models will send multiple webkitneedkey events
  1318.  *   with the same init data. If the duplicates are suppressed, playback
  1319.  *   will stall without errors.
  1320.  *   <br>
  1321.  *   Defaults to <code>false</code> on Tizen 2, and <code>true</code> for all
  1322.  *   other browsers.
  1323.  * @property {string} defaultAudioRobustnessForWidevine
  1324.  *   Specify the default audio security level for Widevine when audio robustness
  1325.  *   is not specified.
  1326.  *   <br>
  1327.  *   Defaults to <code>'SW_SECURE_CRYPTO'</code>.
  1328.  * @property {string} defaultVideoRobustnessForWidevine
  1329.  *   Specify the default video security level for Widevine when video robustness
  1330.  *   is not specified.
  1331.  *   <br>
  1332.  *   Defaults to <code>'SW_SECURE_DECODE'</code>.
  1333.  * @exportDoc
  1334.  */
  1335. shaka.extern.DrmConfiguration;
  1337. /**
  1338.  * @typedef {function(!Uint8Array, string, ?shaka.extern.DrmInfo):!Uint8Array}
  1339.  *
  1340.  * @description
  1341.  * A callback function to handle custom content ID signaling for FairPlay
  1342.  * content.
  1343.  *
  1344.  * @exportDoc
  1345.  */
  1346. shaka.extern.InitDataTransform;
  1349. /**
  1350.  * @typedef {{
  1351.  *   tagName: !string,
  1352.  *   attributes: !Object<string, string>,
  1353.  *   children: !Array<shaka.extern.xml.Node | string>,
  1354.  *   parent: ?shaka.extern.xml.Node
  1355.  * }}
  1356.  *
  1357.  * @description
  1358.  *   Data structure for xml nodes as simple objects
  1359.  *
  1360.  * @property {!string} tagName
  1361.  *   The name of the element
  1362.  * @property {!object} attributes
  1363.  *   The attributes of the element
  1364.  * @property {!Array<shaka.extern.xml.Node | string>} children
  1365.  *   The child nodes or string body of the element
  1366.  * @property {?shaka.extern.xml.Node} parent
  1367.  *   The parent of the current element
  1368.  *
  1369.  * @exportDoc
  1370.  */
  1371. shaka.extern.xml.Node;
  1373. /**
  1374.  * @typedef {{
  1375.  *   clockSyncUri: string,
  1376.  *   disableXlinkProcessing: boolean,
  1377.  *   xlinkFailGracefully: boolean,
  1378.  *   ignoreMinBufferTime: boolean,
  1379.  *   autoCorrectDrift: boolean,
  1380.  *   initialSegmentLimit: number,
  1381.  *   ignoreSuggestedPresentationDelay: boolean,
  1382.  *   ignoreEmptyAdaptationSet: boolean,
  1383.  *   ignoreMaxSegmentDuration: boolean,
  1384.  *   keySystemsByURI: !Object<string, string>,
  1385.  *   manifestPreprocessor: function(!Element),
  1386.  *   manifestPreprocessorTXml: function(!shaka.extern.xml.Node),
  1387.  *   sequenceMode: boolean,
  1388.  *   multiTypeVariantsAllowed: boolean,
  1389.  *   useStreamOnceInPeriodFlattening: boolean,
  1390.  *   enableFastSwitching: boolean
  1391.  * }}
  1392.  *
  1393.  * @property {string} clockSyncUri
  1394.  *   A default clock sync URI to be used with live streams which do not
  1395.  *   contain any clock sync information.  The <code>Date</code> header from this
  1396.  *   URI will be used to determine the current time.
  1397.  *   <br>
  1398.  *   Defaults to <code>''</code>.
  1399.  * @property {boolean} disableXlinkProcessing
  1400.  *   If true, xlink-related processing will be disabled.
  1401.  *   <br>
  1402.  *   Defaults to <code>true</code>.
  1403.  * @property {boolean} xlinkFailGracefully
  1404.  *   If true, xlink-related errors will result in a fallback to the tag's
  1405.  *   existing contents. If false, xlink-related errors will be propagated
  1406.  *   to the application and will result in a playback failure.
  1407.  *   <br>
  1408.  *   Defaults to <code>false</code>.
  1409.  * @property {boolean} ignoreMinBufferTime
  1410.  *   If true will cause DASH parser to ignore <code>minBufferTime</code> from
  1411.  *   manifest.
  1412.  *   <br>
  1413.  *   Defaults to <code>false</code>.
  1414.  * @property {boolean} autoCorrectDrift
  1415.  *   If <code>true</code>, ignore the <code>availabilityStartTime</code> in the
  1416.  *   manifest and instead use the segments to determine the live edge.  This
  1417.  *   allows us to play streams that have a lot of drift.  If <code>false</code>,
  1418.  *   we can't play content where the manifest specifies segments in the future.
  1419.  *   <br>
  1420.  *   Defaults to <code>true</code>.
  1421.  * @property {number} initialSegmentLimit
  1422.  *   The maximum number of initial segments to generate for
  1423.  *   <code>SegmentTemplate</code> with fixed-duration segments.  This is limited
  1424.  *   to avoid excessive memory consumption with very large
  1425.  *   <code>timeShiftBufferDepth</code> values.
  1426.  *   <br>
  1427.  *   Defaults to <code>1000</code>.
  1428.  * @property {boolean} ignoreSuggestedPresentationDelay
  1429.  *   If true will cause DASH parser to ignore
  1430.  *   <code>suggestedPresentationDelay</code> from manifest.
  1431.  *   <br>
  1432.  *   Defaults to <code>false</code>.
  1433.  * @property {boolean} ignoreEmptyAdaptationSet
  1434.  *   If true will cause DASH parser to ignore
  1435.  *   empty <code>AdaptationSet</code> from manifest.
  1436.  *   <br>
  1437.  *   Defaults to <code>false</code>.
  1438.  * @property {boolean} ignoreMaxSegmentDuration
  1439.  *   If true will cause DASH parser to ignore
  1440.  *   <code>maxSegmentDuration</code> from manifest.
  1441.  *   <br>
  1442.  *   Defaults to <code>false</code>.
  1443.  * @property {Object<string, string>} keySystemsByURI
  1444.  *   A map of scheme URI to key system name. Defaults to default key systems
  1445.  *   mapping handled by Shaka.
  1446.  * @property {function(!Element)} manifestPreprocessor
  1447.  *   <b>DEPRECATED</b>: Use manifestPreprocessorTXml instead.
  1448.  *   Called immediately after the DASH manifest has been parsed into an
  1449.  *   XMLDocument. Provides a way for applications to perform efficient
  1450.  *   preprocessing of the manifest.
  1451.  * @property {function(!shaka.extern.xml.Node)} manifestPreprocessorTXml
  1452.  *   Called immediately after the DASH manifest has been parsed into an
  1453.  *   XMLDocument. Provides a way for applications to perform efficient
  1454.  *   preprocessing of the manifest.
  1455.  * @property {boolean} sequenceMode
  1456.  *   If true, the media segments are appended to the SourceBuffer in
  1457.  *   "sequence mode" (ignoring their internal timestamps).
  1458.  *   <br>
  1459.  *   Defaults to <code>false</code>.
  1460.  * @property {boolean} multiTypeVariantsAllowed
  1461.  *   If true, the manifest parser will create variants that have multiple
  1462.  *   mimeTypes or codecs for video or for audio if there is no other choice.
  1463.  *   Meant for content where some periods are only available in one mimeType or
  1464.  *   codec, and other periods are only available in a different mimeType or
  1465.  *   codec. For example, a stream with baked-in ads where the audio codec does
  1466.  *   not match the main content.
  1467.  *   Might result in undesirable behavior if mediaSource.codecSwitchingStrategy
  1468.  *   is not set to SMOOTH.
  1469.  *   <br>
  1470.  *   Defaults to true if SMOOTH codec switching is supported, RELOAD overwise.
  1471.  * @property {boolean} useStreamOnceInPeriodFlattening
  1472.  *   If period combiner is used, this option ensures every stream is used
  1473.  *   only once in period flattening. It speeds up underlying algorithm
  1474.  *   but may raise issues if manifest does not have stream consistency
  1475.  *   between periods.
  1476.  *   <br>
  1477.  *   Defaults to <code>false</code>.
  1478.  * @property {boolean} enableFastSwitching
  1479.  *   If false, disables fast switching track recognition.
  1480.  *   <br>
  1481.  *   Defaults to <code>true</code>.
  1482.  * @exportDoc
  1483.  */
  1484. shaka.extern.DashManifestConfiguration;
  1487. /**
  1488.  * @typedef {{
  1489.  *   ignoreTextStreamFailures: boolean,
  1490.  *   ignoreImageStreamFailures: boolean,
  1491.  *   defaultAudioCodec: string,
  1492.  *   defaultVideoCodec: string,
  1493.  *   ignoreManifestProgramDateTime: boolean,
  1494.  *   ignoreManifestProgramDateTimeForTypes: !Array<string>,
  1495.  *   mediaPlaylistFullMimeType: string,
  1496.  *   liveSegmentsDelay: number,
  1497.  *   sequenceMode: boolean,
  1498.  *   ignoreManifestTimestampsInSegmentsMode: boolean,
  1499.  *   disableCodecGuessing: boolean,
  1500.  *   disableClosedCaptionsDetection: boolean,
  1501.  *   allowLowLatencyByteRangeOptimization: boolean,
  1502.  *   allowRangeRequestsToGuessMimeType: boolean
  1503.  * }}
  1504.  *
  1505.  * @property {boolean} ignoreTextStreamFailures
  1506.  *   If <code>true</code>, ignore any errors in a text stream and filter out
  1507.  *   those streams.
  1508.  *   <br>
  1509.  *   Defaults to <code>false</code>.
  1510.  * @property {boolean} ignoreImageStreamFailures
  1511.  *   If <code>true</code>, ignore any errors in a image stream and filter out
  1512.  *   those streams.
  1513.  *   <br>
  1514.  *   Defaults to <code>false</code>.
  1515.  * @property {string} defaultAudioCodec
  1516.  *   The default audio codec if it is not specified in the HLS playlist.
  1517.  *   <br>
  1518.  *   Defaults to <code>'mp4a.40.2'</code>.
  1519.  * @property {string} defaultVideoCodec
  1520.  *   The default video codec if it is not specified in the HLS playlist.
  1521.  *   <br>
  1522.  *   Defaults to <code>'avc1.42E01E'</code>.
  1523.  * @property {boolean} ignoreManifestProgramDateTime
  1524.  *   If <code>true</code>, the HLS parser will ignore the
  1525.  *   <code>EXT-X-PROGRAM-DATE-TIME</code> tags in the manifest and use media
  1526.  *   sequence numbers instead. It also causes EXT-X-DATERANGE tags to be
  1527.  *   ignored.  Meant for streams where <code>EXT-X-PROGRAM-DATE-TIME</code> is
  1528.  *   incorrect or malformed.
  1529.  *   <br>
  1530.  *   Defaults to <code>false</code>.
  1531.  * @property {!Array<string>} ignoreManifestProgramDateTimeForTypes
  1532.  *   An array of strings representing types for which
  1533.  *   <code>EXT-X-PROGRAM-DATE-TIME</code> should be ignored. Only used if the
  1534.  *   the main ignoreManifestProgramDateTime is set to false.
  1535.  *   For example, setting this to ['text', 'video'] will cause the PDT values
  1536.  *   text and video streams to be ignored, while still using the PDT values for
  1537.  *   audio.
  1538.  *   <br>
  1539.  *   Defaults to <code>[]</code>.
  1540.  * @property {string} mediaPlaylistFullMimeType
  1541.  *   A string containing a full mime type, including both the basic mime type
  1542.  *   and also the codecs. Used when the HLS parser parses a media playlist
  1543.  *   directly, required since all of the mime type and codecs information is
  1544.  *   contained within the master playlist.
  1545.  *   You can use the <code>shaka.util.MimeUtils.getFullType()</code> utility to
  1546.  *   format this value.
  1547.  *   <br>
  1548.  *   Defaults to <code>'video/mp2t; codecs="avc1.42E01E, mp4a.40.2"'</code>.
  1549.  * @property {number} liveSegmentsDelay
  1550.  *   The default presentation delay will be calculated as a number of segments.
  1551.  *   This is the number of segments for this calculation.
  1552.  *   <br>
  1553.  *   Defaults to <code>3</code>.
  1554.  * @property {boolean} sequenceMode
  1555.  *   If true, the media segments are appended to the SourceBuffer in
  1556.  *   "sequence mode" (ignoring their internal timestamps).
  1557.  *   <br>
  1558.  *   Defaults to <code>true</code> except on WebOS 3, Tizen 2,
  1559.  *   Tizen 3 and PlayStation 4 whose default value is <code>false</code>.
  1560.  * @property {boolean} ignoreManifestTimestampsInSegmentsMode
  1561.  *   If true, don't adjust the timestamp offset to account for manifest
  1562.  *   segment durations being out of sync with segment durations. In other
  1563.  *   words, assume that there are no gaps in the segments when appending
  1564.  *   to the SourceBuffer, even if the manifest and segment times disagree.
  1565.  *   Only applies when sequenceMode is <code>false</code>.
  1566.  *   <br>
  1567.  *   Defaults to <code>false</code>.
  1568.  * @property {boolean} disableCodecGuessing
  1569.  *   If set to true, the HLS parser won't automatically guess or assume default
  1570.  *   codec for playlists with no "CODECS" attribute. Instead, it will attempt to
  1571.  *   extract the missing information from the media segment.
  1572.  *   As a consequence, lazy-loading media playlists won't be possible for this
  1573.  *   use case, which may result in longer video startup times.
  1574.  *   <br>
  1575.  *   Defaults to <code>false</code>.
  1576.  * @property {boolean} disableClosedCaptionsDetection
  1577.  *   If true, disables the automatic detection of closed captions.
  1578.  *   Otherwise, in the absence of a EXT-X-MEDIA tag with TYPE="CLOSED-CAPTIONS",
  1579.  *   Shaka Player will attempt to detect captions based on the media data.
  1580.  *   <br>
  1581.  *   Defaults to <code>false</code>.
  1582.  * @property {boolean} allowLowLatencyByteRangeOptimization
  1583.  *   If set to true, the HLS parser will optimize operation with LL and partial
  1584.  *   byte range segments. More info in
  1585.  *   https://www.akamai.com/blog/performance/-using-ll-hls-with-byte-range-addressing-to-achieve-interoperabi
  1586.  *   <br>
  1587.  *   Defaults to <code>true</code>.
  1588.  * @property {boolean} allowRangeRequestsToGuessMimeType
  1589.  *   If set to true, the HLS parser will use range request (only first byte) to
  1590.  *   guess the mime type.
  1591.  *   <br>
  1592.  *   Defaults to <code>false</code>.
  1593.  * @exportDoc
  1594.  */
  1595. shaka.extern.HlsManifestConfiguration;
  1598. /**
  1599.  * @typedef {{
  1600.  *   manifestPreprocessor: function(!Element),
  1601.  *   manifestPreprocessorTXml: function(!shaka.extern.xml.Node),
  1602.  *   sequenceMode: boolean,
  1603.  *   keySystemsBySystemId: !Object<string, string>
  1604.  * }}
  1605.  *
  1606.  * @property {function(!Element)} manifestPreprocessor
  1607.  *   <b>DEPRECATED</b>: Use manifestPreprocessorTXml instead.
  1608.  *   Called immediately after the MSS manifest has been parsed into an
  1609.  *   XMLDocument. Provides a way for applications to perform efficient
  1610.  *   preprocessing of the manifest.
  1611.  * @property {function(!shaka.extern.xml.Node)} manifestPreprocessorTXml
  1612.  *   Called immediately after the MSS manifest has been parsed into an
  1613.  *   XMLDocument. Provides a way for applications to perform efficient
  1614.  *   preprocessing of the manifest.
  1615.  * @property {boolean} sequenceMode
  1616.  *   If true, the media segments are appended to the SourceBuffer in
  1617.  *   "sequence mode" (ignoring their internal timestamps).
  1618.  *   <br>
  1619.  *   Defaults to <code>false</code>.
  1620.  * @property {Object<string, string>} keySystemsBySystemId
  1621.  *   A map of system id to key system name. Defaults to default key systems
  1622.  *   mapping handled by Shaka.
  1623.  * @exportDoc
  1624.  */
  1625. shaka.extern.MssManifestConfiguration;
  1628. /**
  1629.  * @typedef {{
  1630.  *   retryParameters: shaka.extern.RetryParameters,
  1631.  *   availabilityWindowOverride: number,
  1632.  *   disableAudio: boolean,
  1633.  *   disableVideo: boolean,
  1634.  *   disableText: boolean,
  1635.  *   disableThumbnails: boolean,
  1636.  *   disableIFrames: boolean,
  1637.  *   defaultPresentationDelay: number,
  1638.  *   segmentRelativeVttTiming: boolean,
  1639.  *   dash: shaka.extern.DashManifestConfiguration,
  1640.  *   hls: shaka.extern.HlsManifestConfiguration,
  1641.  *   mss: shaka.extern.MssManifestConfiguration,
  1642.  *   raiseFatalErrorOnManifestUpdateRequestFailure: boolean,
  1643.  *   continueLoadingWhenPaused: boolean,
  1644.  *   ignoreSupplementalCodecs: boolean,
  1645.  *   updatePeriod: number,
  1646.  *   ignoreDrmInfo: boolean
  1647.  * }}
  1648.  *
  1649.  * @property {shaka.extern.RetryParameters} retryParameters
  1650.  *   Retry parameters for manifest requests.
  1651.  * @property {number} availabilityWindowOverride
  1652.  *   A number, in seconds, that overrides the availability window in the
  1653.  *   manifest, or <code>NaN</code> if the default value should be used.  This is
  1654.  *   enforced by the manifest parser, so custom manifest parsers should take
  1655.  *   care to honor this parameter.
  1656.  *   <br>
  1657.  *   Defaults to <code>NaN</code>.
  1658.  * @property {boolean} disableAudio
  1659.  *   If <code>true</code>, the audio tracks are ignored.
  1660.  *   <br>
  1661.  *   Defaults to <code>false</code>.
  1662.  * @property {boolean} disableVideo
  1663.  *   If <code>true</code>, the video tracks are ignored.
  1664.  *   <br>
  1665.  *   Defaults to <code>false</code>.
  1666.  * @property {boolean} disableText
  1667.  *   If <code>true</code>, the text tracks are ignored.
  1668.  *   <br>
  1669.  *   Defaults to <code>false</code>.
  1670.  * @property {boolean} disableThumbnails
  1671.  *   If <code>true</code>, the image tracks are ignored.
  1672.  *   <br>
  1673.  *   Defaults to <code>false</code>.
  1674.  * @property {boolean} disableIFrames
  1675.  *   If <code>true</code>, the I-Frames tracks are ignored.
  1676.  *   <br>
  1677.  *   Defaults to <code>false</code>.
  1678.  * @property {number} defaultPresentationDelay
  1679.  *   For DASH, it's a default <code>presentationDelay</code> value if
  1680.  *   <code>suggestedPresentationDelay</code> is missing in the MPEG DASH
  1681.  *   manifest. The default value is the lower of <code>1.5 *
  1682.  *   minBufferTime</code> and <code>segmentAvailabilityDuration</code> if not
  1683.  *   configured or set as 0.
  1684.  *   For HLS, the default value is 3 segments duration if not configured or
  1685.  *   set as 0.
  1686.  *   <br>
  1687.  *   Defaults to <code>0</code>.
  1688.  * @property {boolean} segmentRelativeVttTiming
  1689.  *   Option to calculate VTT text timings relative to the segment start
  1690.  *   instead of relative to the period start (which is the default).
  1691.  *   <br>
  1692.  *   Defaults to <code>false</code>.
  1693.  * @property {shaka.extern.DashManifestConfiguration} dash
  1694.  *   Advanced parameters used by the DASH manifest parser.
  1695.  * @property {shaka.extern.HlsManifestConfiguration} hls
  1696.  *   Advanced parameters used by the HLS manifest parser.
  1697.  * @property {shaka.extern.MssManifestConfiguration} mss
  1698.  *   Advanced parameters used by the MSS manifest parser.
  1699.  * @property {boolean} raiseFatalErrorOnManifestUpdateRequestFailure
  1700.  *   If true, manifest update request failures will cause a fatal error.
  1701.  *   <br>
  1702.  *   Defaults to <code>false</code>.
  1703.  * @property {boolean} continueLoadingWhenPaused
  1704.  *   If true, live manifest will be updated with the regular intervals even if
  1705.  *   the video is paused.
  1706.  *   <br>
  1707.  *   Defaults to <code>true</code>.
  1708.  * @property {boolean} ignoreSupplementalCodecs
  1709.  *   If true, ignores supplemental codecs.
  1710.  *   <br>
  1711.  *   Defaults to <code>false</code>.
  1712.  * @property {number} updatePeriod
  1713.  *   For DASH:
  1714.  *   Override the minimumUpdatePeriod of the manifest. The value is in seconds.
  1715.  *   If the value is greater than the minimumUpdatePeriod, it will update the
  1716.  *   manifest less frequently. If you update the value during for a dynamic
  1717.  *   manifest, it will directly trigger a new download of the manifest.
  1718.  *   <br>
  1719.  *   For HLS:
  1720.  *   Override the update period of the playlist. The value is in seconds.
  1721.  *   If the value is less than 0, the period will be determined based on the
  1722.  *   segment length.  If the value is greater than 0, it will update the target
  1723.  *   duration.  If you update the value during the live, it will directly
  1724.  *   trigger a new download of the manifest.
  1725.  *   <br>
  1726.  *   Defaults to <code>-1</code>.
  1727.  * @property {boolean} ignoreDrmInfo
  1728.  *   If true will cause DASH/HLS parser to ignore DRM information specified
  1729.  *   by the manifest and treat it as if it signaled no particular key
  1730.  *   system and contained no init data.
  1731.  *   <br>
  1732.  *   Defaults to <code>false</code>.
  1733.  * @exportDoc
  1734.  */
  1735. shaka.extern.ManifestConfiguration;
  1737. /**
  1738.  * @typedef {{
  1739.  *   enabled: boolean,
  1740.  *   stabilityThreshold: number,
  1741.  *   rebufferIncrement: number,
  1742.  *   maxAttempts: number,
  1743.  *   maxLatency: number,
  1744.  *   minLatency: number
  1745.  * }}
  1746.  *
  1747.  * @description
  1748.  * Dynamic Target Latency configuration options.
  1749.  *
  1750.  * @property {boolean} enabled
  1751.  *   If <code>true</code>, dynamic latency for live sync is enabled. When
  1752.  *   enabled, the target latency will be adjusted closer to the min latency
  1753.  *   when playback is stable (see <code>stabilityThreshold</code>). If
  1754.  *   there are rebuffering events, then the target latency will move towards
  1755.  *   the max latency value in increments of <code>rebufferIncrement</code>.
  1756.  *   <br>
  1757.  *   Defaults to <code>false</code>
  1758.  * @property {number} rebufferIncrement
  1759.  *   The value, in seconds, to increment the target latency towards
  1760.  *   <code>maxLatency</code> after a rebuffering event.
  1761.  *   <br>
  1762.  *   Defaults to <code>0.5</code>
  1763.  * @property {number} stabilityThreshold
  1764.  *   Number of seconds after a rebuffering before we are considered stable and
  1765.  *   will move the target latency towards <code>minLatency</code>
  1766.  *   value.
  1767.  *   <br>
  1768.  *   Defaults to <code>60</code>.
  1769.  * @property {number} maxAttempts
  1770.  *   Number of times that dynamic target latency will back off to
  1771.  *   <code>maxLatency</code> and attempt to adjust it closer to
  1772.  *   <code>minLatency</code>.
  1773.  *   <br>
  1774.  *   Defaults to <code>10</code>.
  1775.  * @property {number} maxLatency
  1776.  *   The latency to use when a rebuffering event causes us to back off from
  1777.  *   the live edge.
  1778.  *   <br>
  1779.  *   Defaults to <code>4</code>.
  1780.  * @property {number} minLatency
  1781.  *   The latency to work towards when the network is stable and we want to get
  1782.  *   closer to the live edge.
  1783.  *   <br>
  1784.  *   Defaults to <code>1</code>.
  1785.  * @exportDoc
  1786.  */
  1787. shaka.extern.DynamicTargetLatencyConfiguration;
  1790. /**
  1791.  * @typedef {{
  1792.  *   enabled: boolean,
  1793.  *   targetLatency: number,
  1794.  *   targetLatencyTolerance: number,
  1795.  *   maxPlaybackRate: number,
  1796.  *   minPlaybackRate: number,
  1797.  *   panicMode: boolean,
  1798.  *   panicThreshold: number,
  1799.  *   dynamicTargetLatency: shaka.extern.DynamicTargetLatencyConfiguration
  1800.  * }}
  1801.  *
  1802.  * @description
  1803.  * LiveSync configuration options.
  1804.  *
  1805.  * @property {boolean} enabled
  1806.  *   Enable the live stream sync against the live edge by changing the playback
  1807.  *   rate.
  1808.  *   Note: on some SmartTVs, if this is activated, it may not work or the sound
  1809.  *   may be lost when activated.
  1810.  *   <br>
  1811.  *   Defaults to <code>false</code>.
  1812.  * @property {number} targetLatency
  1813.  *   Preferred latency, in seconds. Effective only if liveSync is true.
  1814.  *   <br>
  1815.  *   Defaults to <code>0.5</code>.
  1816.  * @property {number} targetLatencyTolerance
  1817.  *   Latency tolerance for target latency, in seconds. Effective only if
  1818.  *   liveSync is enabled.
  1819.  *   <br>
  1820.  *   Defaults to <code>0.5</code>.
  1821.  * @property {number} maxPlaybackRate
  1822.  *   Max playback rate used for latency chasing. It is recommended to use a
  1823.  *   value between 1 and 2. Effective only if liveSync is enabled.
  1824.  *   <br>
  1825.  *   Defaults to <code>1.1</code>.
  1826.  * @property {number} minPlaybackRate
  1827.  *   Minimum playback rate used for latency chasing. It is recommended to use a
  1828.  *   value between 0 and 1. Effective only if liveSync is enabled.
  1829.  *   <br>
  1830.  *   Defaults to <code>0.95</code>.
  1831.  * @property {boolean} panicMode
  1832.  *   If <code>true</code>, panic mode for live sync is enabled. When enabled,
  1833.  *   will set the playback rate to the <code>minPlaybackRate</code>
  1834.  *   until playback has continued past a rebuffering for longer than the
  1835.  *   <code>panicThreshold</code>.
  1836.  *   <br>
  1837.  *   Defaults to <code>false</code>.
  1838.  * @property {number} panicThreshold
  1839.  *   Number of seconds that playback stays in panic mode after a rebuffering.
  1840.  *   <br>
  1841.  *   Defaults to <code>60</code>.
  1842.  * @property {shaka.extern.DynamicTargetLatencyConfiguration
  1843.  *           } dynamicTargetLatency
  1844.  *
  1845.  *   The dynamic target latency config for dynamically adjusting the target
  1846.  *   latency to be closer to edge when network conditions are good and to back
  1847.  *   off when network conditions are bad.
  1848.  * @exportDoc
  1849.  */
  1850. shaka.extern.LiveSyncConfiguration;
  1853. /**
  1854.  * @typedef {{
  1855.  *   retryParameters: shaka.extern.RetryParameters,
  1856.  *   failureCallback: function(!shaka.util.Error),
  1857.  *   rebufferingGoal: number,
  1858.  *   bufferingGoal: number,
  1859.  *   bufferBehind: number,
  1860.  *   evictionGoal: number,
  1861.  *   ignoreTextStreamFailures: boolean,
  1862.  *   alwaysStreamText: boolean,
  1863.  *   startAtSegmentBoundary: boolean,
  1864.  *   gapDetectionThreshold: number,
  1865.  *   gapPadding: number,
  1866.  *   gapJumpTimerTime: number,
  1867.  *   durationBackoff: number,
  1868.  *   safeSeekOffset: number,
  1869.  *   safeSeekEndOffset: number,
  1870.  *   stallEnabled: boolean,
  1871.  *   stallThreshold: number,
  1872.  *   stallSkip: number,
  1873.  *   useNativeHlsForFairPlay: boolean,
  1874.  *   inaccurateManifestTolerance: number,
  1875.  *   lowLatencyMode: boolean,
  1876.  *   preferNativeDash: boolean,
  1877.  *   preferNativeHls: boolean,
  1878.  *   updateIntervalSeconds: number,
  1879.  *   observeQualityChanges: boolean,
  1880.  *   maxDisabledTime: number,
  1881.  *   segmentPrefetchLimit: number,
  1882.  *   prefetchAudioLanguages: !Array<string>,
  1883.  *   disableAudioPrefetch: boolean,
  1884.  *   disableTextPrefetch: boolean,
  1885.  *   disableVideoPrefetch: boolean,
  1886.  *   liveSync: shaka.extern.LiveSyncConfiguration,
  1887.  *   allowMediaSourceRecoveries: boolean,
  1888.  *   minTimeBetweenRecoveries: number,
  1889.  *   vodDynamicPlaybackRate: boolean,
  1890.  *   vodDynamicPlaybackRateLowBufferRate: number,
  1891.  *   vodDynamicPlaybackRateBufferRatio: number,
  1892.  *   preloadNextUrlWindow: number,
  1893.  *   loadTimeout: number,
  1894.  *   clearDecodingCache: boolean,
  1895.  *   dontChooseCodecs: boolean,
  1896.  *   shouldFixTimestampOffset: boolean,
  1897.  *   avoidEvictionOnQuotaExceededError: boolean,
  1898.  *   crossBoundaryStrategy: shaka.config.CrossBoundaryStrategy,
  1899.  *   returnToEndOfLiveWindowWhenOutside: boolean
  1900.  * }}
  1901.  *
  1902.  * @description
  1903.  * The StreamingEngine's configuration options.
  1904.  *
  1905.  * @property {shaka.extern.RetryParameters} retryParameters
  1906.  *   Retry parameters for segment requests.
  1907.  * @property {function(!shaka.util.Error)} failureCallback
  1908.  *   A callback to decide what to do on a streaming failure.  Default behavior
  1909.  *   is to retry on live streams and not on VOD.
  1910.  * @property {number} rebufferingGoal
  1911.  *   The minimum number of seconds of content that the StreamingEngine must
  1912.  *   buffer before it can begin playback or can continue playback after it has
  1913.  *   entered into a buffering state (i.e., after it has depleted one more
  1914.  *   more of its buffers).
  1915.  *   When the value is 0, the playback rate is not used to control the buffer.
  1916.  *   <br>
  1917.  *   Defaults to <code>0</code>.
  1918.  * @property {number} bufferingGoal
  1919.  *   The number of seconds of content that the StreamingEngine will attempt to
  1920.  *   buffer ahead of the playhead. This value must be greater than or equal to
  1921.  *   the rebuffering goal.
  1922.  *   <br>
  1923.  *   Defaults to <code>10</code>.
  1924.  * @property {number} bufferBehind
  1925.  *   The maximum number of seconds of content that the StreamingEngine will keep
  1926.  *   in buffer behind the playhead when it appends a new media segment.
  1927.  *   The StreamingEngine will evict content to meet this limit.
  1928.  *   <br>
  1929.  *   Defaults to <code>30</code>.
  1930.  * @property {number} evictionGoal
  1931.  *   The minimum duration in seconds of buffer overflow the StreamingEngine
  1932.  *   requires to start removing content from the buffer.
  1933.  *   Values less than <code>1.0</code> are not recommended.
  1934.  *   <br>
  1935.  *   Defaults to <code>1.0</code>.
  1936.  * @property {boolean} ignoreTextStreamFailures
  1937.  *   If <code>true</code>, the player will ignore text stream failures and
  1938.  *   continue playing other streams.
  1939.  *   <br>
  1940.  *   Defaults to <code>false</code>.
  1941.  * @property {boolean} alwaysStreamText
  1942.  *   If <code>true</code>, always stream text tracks, regardless of whether or
  1943.  *   not they are shown.  This is necessary when using the browser's built-in
  1944.  *   controls, which are not capable of signaling display state changes back to
  1945.  *   Shaka Player.
  1946.  *   Defaults to <code>false</code>.
  1947.  * @property {boolean} startAtSegmentBoundary
  1948.  *   If <code>true</code>, adjust the start time backwards so it is at the start
  1949.  *   of a segment. This affects both explicit start times and calculated start
  1950.  *   time for live streams. This can put us further from the live edge.
  1951.  *   <br>
  1952.  *   Defaults to <code>false</code>.
  1953.  * @property {number} gapDetectionThreshold
  1954.  *   The maximum distance (in seconds) before a gap when we'll automatically
  1955.  *   jump.
  1956.  *   <br>
  1957.  *   Defaults to <code>0.5</code>.
  1958.  * @property {number} gapPadding
  1959.  *   Padding added only for Xbox, Legacy Edge and Tizen.
  1960.  *   Based on our research (specific to Tizen), the gapPadding value must be
  1961.  *   greater than your GOP length.
  1962.  *   It’s crucial to verify this value according to your actual stream.
  1963.  *   <br>
  1964.  *   Defaults to <code>0.01</code> for Xbox and Legacy Edge, Tizen at 2.
  1965.  * @property {number} gapJumpTimerTime
  1966.  *   The polling time in seconds to check for gaps in the media.
  1967.  *   <br>
  1968.  *   Defaults to <code>0.25</code>.
  1969.  * @property {number} durationBackoff
  1970.  *   By default, we will not allow seeking to exactly the duration of a
  1971.  *   presentation.  This field is the number of seconds before duration we will
  1972.  *   seek to when the user tries to seek to or start playback at the duration.
  1973.  *   To disable this behavior, the config can be set to 0.  We recommend using
  1974.  *   the default value unless you have a good reason not to.
  1975.  *   <br>
  1976.  *   Defaults to <code>1</code>.
  1977.  * @property {number} safeSeekOffset
  1978.  *   The amount of seconds that should be added when repositioning the playhead
  1979.  *   after falling out of the availability window or seek. This gives the player
  1980.  *   more time to buffer before falling outside again, but increases the forward
  1981.  *   jump in the stream skipping more content. This is helpful for lower
  1982.  *   bandwidth scenarios.
  1983.  *   <br>
  1984.  *   Defaults to <code>5</code>.
  1985.  * @property {number} safeSeekEndOffset
  1986.  *   The amount of seconds that should be added when repositioning the playhead
  1987.  *   after falling out of the seekable end range. This is helpful for live
  1988.  *   stream with a lot of GAP. This will reposition the playback in the past
  1989.  *   and avoid to be block at the edge and buffer at the next GAP
  1990.  *   <br>
  1991.  *   Defaults to <code>0</code>.
  1992.  * @property {boolean} stallEnabled
  1993.  *   When set to <code>true</code>, the stall detector logic will run.  If the
  1994.  *   playhead stops moving for <code>stallThreshold</code> seconds, the player
  1995.  *   will either seek or pause/play to resolve the stall, depending on the value
  1996.  *   of <code>stallSkip</code>.
  1997.  *   <br>
  1998.  *   Defaults to <code>true</code>.
  1999.  * @property {number} stallThreshold
  2000.  *   The maximum number of seconds that may elapse without the playhead moving
  2001.  *   (when playback is expected) before it will be labeled as a stall.
  2002.  *   <br>
  2003.  *   Defaults to <code>1</code>.
  2004.  * @property {number} stallSkip
  2005.  *   The number of seconds that the player will skip forward when a stall has
  2006.  *   been detected.  If 0, the player will pause and immediately play instead of
  2007.  *   seeking.  A value of 0 is recommended and provided as default on TV
  2008.  *   platforms (WebOS, Tizen, Chromecast, etc).
  2009.  *   <br>
  2010.  *   Defaults to <code>0.1</code>  except on Tizen, WebOS, Chromecast,
  2011.  *   Hisense whose default value is <code>0</code>.
  2012.  * @property {boolean} useNativeHlsForFairPlay
  2013.  *   Desktop Safari has both MediaSource and their native HLS implementation.
  2014.  *   Depending on the application's needs, it may prefer one over the other.
  2015.  *   Warning when disabled: Where single-key DRM streams work fine, multi-keys
  2016.  *   streams is showing unexpected behaviours (stall, audio playing with video
  2017.  *   freezes, ...). Use with care.
  2018.  *   <br>
  2019.  *   Defaults to <code>true</code>.
  2020.  * @property {number} inaccurateManifestTolerance
  2021.  *   The maximum difference, in seconds, between the times in the manifest and
  2022.  *   the times in the segments.  Larger values allow us to compensate for more
  2023.  *   drift (up to one segment duration).  Smaller values reduce the incidence of
  2024.  *   extra segment requests necessary to compensate for drift.
  2025.  *   <br>
  2026.  *   Defaults to <code>2</code>.
  2027.  * @property {boolean} lowLatencyMode
  2028.  *   If <code>true</code>, low latency streaming mode is enabled. If
  2029.  *   lowLatencyMode is set to true, it changes the default config values for
  2030.  *   other things, see: docs/tutorials/config.md
  2031.  *   <br>
  2032.  *   Defaults to <code>false</code>.
  2033.  * @property {boolean} preferNativeDash
  2034.  *   If true, prefer native DASH playback when possible, regardless of platform.
  2035.  *   <br>
  2036.  *   Defaults to <code>false</code>.
  2037.  * @property {boolean} preferNativeHls
  2038.  *   If true, prefer native HLS playback when possible, regardless of platform.
  2039.  *   <br>
  2040.  *   Defaults to <code>false</code>.
  2041.  * @property {number} updateIntervalSeconds
  2042.  *   The minimum number of seconds to see if the manifest has changes.
  2043.  *   <br>
  2044.  *   Defaults to <code>1</code>.
  2045.  * @property {boolean} observeQualityChanges
  2046.  *   If true, monitor media quality changes and emit
  2047.  *   <code>shaka.Player.MediaQualityChangedEvent</code>.
  2048.  *   <br>
  2049.  *   Defaults to <code>false</code>.
  2050.  * @property {number} maxDisabledTime
  2051.  *   The maximum time a variant can be disabled when NETWORK HTTP_ERROR
  2052.  *   is reached, in seconds.
  2053.  *   If all variants are disabled this way, NETWORK HTTP_ERROR will be thrown.
  2054.  *   <br>
  2055.  *   Defaults to <code>30</code>.
  2056.  * @property {number} segmentPrefetchLimit
  2057.  *   The maximum number of segments for each active stream to be prefetched
  2058.  *   ahead of playhead in parallel.
  2059.  *   If <code>0</code>, the segments will be fetched sequentially.
  2060.  *   <br>
  2061.  *   Defaults to <code>1</code>.
  2062.  * @property {!Array<string>} prefetchAudioLanguages
  2063.  *   The audio languages to prefetch.
  2064.  *   <br>
  2065.  *   Defaults to <code>[]</code>.
  2066.  * @property {boolean} disableAudioPrefetch
  2067.  *   If set and prefetch limit is defined, it will prevent from prefetching data
  2068.  *   for audio.
  2069.  *   <br>
  2070.  *   Defaults to <code>false</code>.
  2071.  * @property {boolean} disableTextPrefetch
  2072.  *   If set and prefetch limit is defined, it will prevent from prefetching data
  2073.  *   for text.
  2074.  *   <br>
  2075.  *   Defaults to <code>false</code>.
  2076.  * @property {boolean} disableVideoPrefetch
  2077.  *   If set and prefetch limit is defined, it will prevent from prefetching data
  2078.  *   for video.
  2079.  *   <br>
  2080.  *   Defaults to <code>false</code>.
  2081.  * @property {shaka.extern.LiveSyncConfiguration} liveSync
  2082.  *   The live sync configuration for keeping near the live edge.
  2083.  * @property {boolean} allowMediaSourceRecoveries
  2084.  *   Indicate if we should recover from VIDEO_ERROR resetting Media Source.
  2085.  *   <br>
  2086.  *   Defaults to <code>true</code>.
  2087.  * @property {number} minTimeBetweenRecoveries
  2088.  *   The minimum time between recoveries when VIDEO_ERROR is reached, in
  2089.  *   seconds.
  2090.  *   <br>
  2091.  *   Defaults to <code>5</code>.
  2092.  * @property {boolean} vodDynamicPlaybackRate
  2093.  *   Adapt the playback rate of the player to keep the buffer full.
  2094.  *   <br>
  2095.  *   Defaults to <code>false</code>.
  2096.  * @property {number} vodDynamicPlaybackRateLowBufferRate
  2097.  *   Playback rate to use if the buffer is too small.
  2098.  *   <br>
  2099.  *   Defaults to <code>0.95</code>.
  2100.  * @property {number} vodDynamicPlaybackRateBufferRatio
  2101.  *   Ratio of the <code>bufferingGoal</code> as the low threshold for
  2102.  *   setting the playback rate to
  2103.  *   <code>vodDynamicPlaybackRateLowBufferRate</code>.
  2104.  *   <br>
  2105.  *   Defaults to <code>0.5</code>.
  2106.  * @property {number} preloadNextUrlWindow
  2107.  *   The window of time at the end of the presentation to begin preloading the
  2108.  *   next URL, such as one specified by a urn:mpeg:dash:chaining:2016 element
  2109.  *   in DASH. Measured in seconds. If the value is 0, the next URL will not
  2110.  *   be preloaded at all.
  2111.  *   <br>
  2112.  *   Defaults to <code>30</code>.
  2113.  * @property {number} loadTimeout
  2114.  *   The maximum timeout to reject the load when using src= in case the content
  2115.  *   does not work correctly.  Measured in seconds.
  2116.  *   <br>
  2117.  *   Defaults to <code>30</code>.
  2118.  * @property {boolean} clearDecodingCache
  2119.  *   Clears decodingInfo and MediaKeySystemAccess cache during player unload
  2120.  *   as these objects may become corrupt and cause issues during subsequent
  2121.  *   playbacks on some platforms.
  2122.  *   <br>
  2123.  *   Defaults to <code>true</code> on PlayStation devices and to
  2124.  *   <code>false</code> on other devices.
  2125.  * @property {boolean} dontChooseCodecs
  2126.  *   If true, we don't choose codecs in the player, and keep all the variants.
  2127.  *   <br>
  2128.  *   Defaults to <code>false</code>.
  2129.  * @property {boolean} shouldFixTimestampOffset
  2130.  *   If true, we will try to fix problems when the timestampOffset is less than
  2131.  *   the baseMediaDecodeTime. This only works when the manifest is DASH with
  2132.  *   MP4 segments.
  2133.  *   <br>
  2134.  *   Defaults to <code>false</code> except on Tizen, WebOS whose default value
  2135.  *   is <code>true</code>.
  2136.  * @property {boolean} avoidEvictionOnQuotaExceededError
  2137.  *   Avoid evict content on QuotaExceededError.
  2138.  *   <br>
  2139.  *   Defaults to <code>false</code>.
  2140.  * @property {shaka.config.CrossBoundaryStrategy} crossBoundaryStrategy
  2141.  *   Allows MSE to be reset when crossing a boundary. Optionally, we can stop
  2142.  *   resetting MSE when MSE passed an encrypted boundary.
  2143.  *   Defaults to <code>KEEP</code> except on Tizen 3 where the default value
  2144.  *   is <code>RESET_TO_ENCRYPTED</code> and WebOS 3 where the default value
  2145.  *   is <code>RESET</code>.
  2146.  * @property {boolean} returnToEndOfLiveWindowWhenOutside
  2147.  *   If true, when the playhead is behind the start of the live window,
  2148.  *   it will be moved to the end of the live window, instead of the start.
  2149.  *   <br>
  2150.  *   Defaults to <code>false</code>.
  2151.  * @exportDoc
  2152.  */
  2153. shaka.extern.StreamingConfiguration;
  2156. /**
  2157.  * @typedef {{
  2158.  *   forceHTTP: boolean,
  2159.  *   forceHTTPS: boolean,
  2160.  *   minBytesForProgressEvents: number
  2161.  * }}
  2162.  *
  2163.  * @description
  2164.  * The Networking's configuration options.
  2165.  *
  2166.  * @property {boolean} forceHTTP
  2167.  *   If true, if the protocol is HTTPs change it to HTTP.
  2168.  *   If both forceHTTP and forceHTTPS are set, forceHTTPS wins.
  2169.  *   <br>
  2170.  *   Defaults to <code>false</code>.
  2171.  * @property {boolean} forceHTTPS
  2172.  *   If true, if the protocol is HTTP change it to HTTPs.
  2173.  *   If both forceHTTP and forceHTTPS are set, forceHTTPS wins.
  2174.  *   <br>
  2175.  *   Defaults to <code>false</code>.
  2176.  * @property {number} minBytesForProgressEvents
  2177.  *   Defines minimum number of bytes that should be used to emit progress event,
  2178.  *   if possible. To avoid issues around feeding ABR with request history, this
  2179.  *   value should be greater than or equal to `abr.advanced.minBytes`.
  2180.  *   By default equals 16e3 (the same value as `abr.advanced.minBytes`).
  2181.  * @exportDoc
  2182.  */
  2183. shaka.extern.NetworkingConfiguration;
  2186. /**
  2187.  * @typedef {{
  2188.  *   codecSwitchingStrategy: shaka.config.CodecSwitchingStrategy,
  2189.  *   addExtraFeaturesToSourceBuffer: function(string): string,
  2190.  *   forceTransmux: boolean,
  2191.  *   insertFakeEncryptionInInit: boolean,
  2192.  *   correctEc3Enca: boolean,
  2193.  *   modifyCueCallback: shaka.extern.TextParser.ModifyCueCallback,
  2194.  *   dispatchAllEmsgBoxes: boolean,
  2195.  *   useSourceElements: boolean,
  2196.  *   durationReductionEmitsUpdateEnd: boolean
  2197.  * }}
  2198.  *
  2199.  * @description
  2200.  *   Media source configuration.
  2201.  *
  2202.  * @property {shaka.config.CodecSwitchingStrategy} codecSwitchingStrategy
  2203.  *   Allow codec switching strategy. SMOOTH loading uses
  2204.  *   SourceBuffer.changeType. RELOAD uses cycling of MediaSource.
  2205.  *   <br>
  2206.  *   Defaults to SMOOTH if SMOOTH codec switching is supported, RELOAD
  2207.  *   overwise.
  2208.  * @property {function(string): string} addExtraFeaturesToSourceBuffer
  2209.  *   Callback to generate extra features string based on used MIME type.
  2210.  *   Some platforms may need to pass features when initializing the
  2211.  *   sourceBuffer.
  2212.  *   This string is ultimately appended to a MIME type in addSourceBuffer() &
  2213.  *   changeType().
  2214.  * @property {boolean} forceTransmux
  2215.  *   If this is <code>true</code>, we will transmux AAC and TS content even if
  2216.  *   not strictly necessary for the assets to be played.
  2217.  *   <br>
  2218.  *   Defaults to <code>false</code>.
  2219.  * @property {boolean} insertFakeEncryptionInInit
  2220.  *   If true, will apply a work-around for non-encrypted init segments on
  2221.  *   encrypted content for some platforms.
  2222.  *   <br><br>
  2223.  *   See https://github.com/shaka-project/shaka-player/issues/2759.
  2224.  *   <br><br>
  2225.  *   If you know you don't need this, you can set this value to
  2226.  *   <code>false</code> to gain a few milliseconds on loading time and seek
  2227.  *   time.
  2228.  *   <br><br>
  2229.  *   <br>
  2230.  *   Defaults to <code>true</code>.
  2231.  * @property {boolean} correctEc3Enca
  2232.  *   If true, will apply a work-around for Audio init segments signaling
  2233.  *   EC-3 codec with protection. This will force the ChannelCount field
  2234.  *   of the 'enca' box to be set to 2, which is required via the dolby
  2235.  *   spec.
  2236.  *   <br>
  2237.  *   This value defaults to <code>false</code>.
  2238.  * @property {shaka.extern.TextParser.ModifyCueCallback} modifyCueCallback
  2239.  *    A callback called for each cue after it is parsed, but right before it
  2240.  *    is appended to the presentation.
  2241.  *    Gives a chance for client-side editing of cue text, cue timing, etc.
  2242.  * @property {boolean} dispatchAllEmsgBoxes
  2243.  *   If true, all emsg boxes are parsed and dispatched.
  2244.  *   <br>
  2245.  *   Defaults to <code>false</code>.
  2246.  * @property {boolean} useSourceElements
  2247.  *   If true, uses <source> element. Otherwise,
  2248.  *   sets the mediaSource url blob to src attribute.
  2249.  *   Disabling it will prevent using AirPlay on MSE.
  2250.  *   <br>
  2251.  *   Defaults to <code>true</code>.
  2252.  * @property {boolean} durationReductionEmitsUpdateEnd
  2253.  *   https://www.w3.org/TR/media-source-2/#duration-change-algorithm
  2254.  *   "Duration reductions that would truncate currently buffered media are
  2255.  *   disallowed.
  2256.  *   When truncation is necessary, use remove() to reduce the buffered range
  2257.  *   before updating duration."
  2258.  *   When set indicates media source duration change can truncate buffer, hence
  2259.  *   updateend event is expected on setDuration operation if new duration is
  2260.  *   smaller than existing value.
  2261.  *   <br>
  2262.  *   Defaults to <code>true</code>.
  2263.  * @exportDoc
  2264.  */
  2265. shaka.extern.MediaSourceConfiguration;
  2268. /**
  2269.  * @typedef {{
  2270.  *   customPlayheadTracker: boolean,
  2271.  *   skipPlayDetection: boolean,
  2272.  *   supportsMultipleMediaElements: boolean,
  2273.  *   disableHLSInterstitial: boolean,
  2274.  *   disableDASHInterstitial: boolean,
  2275.  *   allowPreloadOnDomElements: boolean,
  2276.  *   allowStartInMiddleOfInterstitial: boolean
  2277.  * }}
  2278.  *
  2279.  * @description
  2280.  *   Ads configuration.
  2281.  *
  2282.  * @property {boolean} customPlayheadTracker
  2283.  *   If this is <code>true</code>, we create a custom playhead tracker for
  2284.  *   Client Side. This is useful because it allows you to implement the use of
  2285.  *   IMA on platforms that do not support multiple video elements.
  2286.  *   <br>
  2287.  *   Defaults to <code>false</code> except on Tizen, WebOS, Chromecast,
  2288.  *   Hisense, PlayStation 4, PlayStation5, Xbox, Vizio whose default value is
  2289.  *   <code>true</code>.
  2290.  * @property {boolean} skipPlayDetection
  2291.  *   If this is true, we will load Client Side ads without waiting for a play
  2292.  *   event.
  2293.  *   <br>
  2294.  *   Defaults to <code>false</code> except on Tizen, WebOS, Chromecast,
  2295.  *   Hisense, PlayStation 4, PlayStation5, Xbox, Vizio whose default value is
  2296.  *   <code>true</code>.
  2297.  * @property {boolean} supportsMultipleMediaElements
  2298.  *   If this is true, the browser supports multiple media elements.
  2299.  *   <br>
  2300.  *   Defaults to <code>true</code> except on Tizen, WebOS, Chromecast,
  2301.  *   Hisense, PlayStation 4, PlayStation5, Xbox, Vizio whose default value is
  2302.  *   <code>false</code>.
  2303.  * @property {boolean} disableHLSInterstitial
  2304.  *   If this is true, we ignore HLS interstitial events.
  2305.  *   <br>
  2306.  *   Defaults to <code>false</code>.
  2307.  * @property {boolean} disableDASHInterstitial
  2308.  *   If this is true, we ignore DASH interstitial events.
  2309.  *   <br>
  2310.  *   Defaults to <code>false</code>.
  2311.  * @property {boolean} allowPreloadOnDomElements
  2312.  *   If this is true, we will use HTMLLinkElement to preload some resources.
  2313.  *   <br>
  2314.  *   Defaults to <code>true</code>.
  2315.  * @property {boolean} allowStartInMiddleOfInterstitial
  2316.  *   If this is true, we will allow start in the middle of an interstitial.
  2317.  *   <br>
  2318.  *   Defaults to <code>true</code>.
  2319.  *
  2320.  * @exportDoc
  2321.  */
  2322. shaka.extern.AdsConfiguration;
  2325. /**
  2326.  * @typedef {{
  2327.  *   enabled: boolean,
  2328.  *   useNetworkInformation: boolean,
  2329.  *   defaultBandwidthEstimate: number,
  2330.  *   restrictions: shaka.extern.Restrictions,
  2331.  *   switchInterval: number,
  2332.  *   bandwidthUpgradeTarget: number,
  2333.  *   bandwidthDowngradeTarget: number,
  2334.  *   advanced: shaka.extern.AdvancedAbrConfiguration,
  2335.  *   restrictToElementSize: boolean,
  2336.  *   restrictToScreenSize: boolean,
  2337.  *   ignoreDevicePixelRatio: boolean,
  2338.  *   clearBufferSwitch: boolean,
  2339.  *   safeMarginSwitch: number,
  2340.  *   cacheLoadThreshold: number,
  2341.  *   minTimeToSwitch: number,
  2342.  *   preferNetworkInformationBandwidth: boolean,
  2343.  *   removeLatencyFromFirstPacketTime: boolean
  2344.  * }}
  2345.  *
  2346.  * @property {boolean} enabled
  2347.  *   If true, enable adaptation by the current AbrManager.
  2348.  *   <br>
  2349.  *   Defaults to <code>true</code>.
  2350.  * @property {boolean} useNetworkInformation
  2351.  *   If true, use the Network Information API in the current AbrManager, if it
  2352.  *   is available in the browser environment.  If the Network Information API is
  2353.  *   used, Shaka Player will ignore the defaultBandwidthEstimate config.
  2354.  *   <br>
  2355.  *   Defaults to <code>true</code>.
  2356.  * @property {number} defaultBandwidthEstimate
  2357.  *   The default bandwidth estimate to use if there is not enough data, in
  2358.  *   bit/sec.  Only used if useNetworkInformation is false, or if the Network
  2359.  *   Information API is not available.
  2360.  *   <br>
  2361.  *   Defaults to <code>1e6</code>.
  2362.  * @property {shaka.extern.Restrictions} restrictions
  2363.  *   The restrictions to apply to ABR decisions.  These are "soft" restrictions.
  2364.  *   Any track that fails to meet these restrictions will not be selected
  2365.  *   automatically, but will still appear in the track list and can still be
  2366.  *   selected via <code>selectVariantTrack()</code>.  If no tracks meet these
  2367.  *   restrictions, AbrManager should not fail, but choose a low-res or
  2368.  *   low-bandwidth variant instead.  It is the responsibility of AbrManager
  2369.  *   implementations to follow these rules and implement this behavior.
  2370.  * @property {number} switchInterval
  2371.  *   The minimum amount of time that must pass between switches, in
  2372.  *   seconds. This keeps us from changing too often and annoying the user.
  2373.  *   <br>
  2374.  *   Defaults to <code>8</code>.
  2375.  * @property {number} bandwidthUpgradeTarget
  2376.  *   The fraction of the estimated bandwidth which we should try to use when
  2377.  *   upgrading.
  2378.  *   <br>
  2379.  *   Defaults to <code>0.85</code>.
  2380.  * @property {number} bandwidthDowngradeTarget
  2381.  *   The largest fraction of the estimated bandwidth we should use. We should
  2382.  *   downgrade to avoid this.
  2383.  *   <br>
  2384.  *   Defaults to <code>0.95</code>.
  2385.  * @property {shaka.extern.AdvancedAbrConfiguration} advanced
  2386.  *   Advanced ABR configuration
  2387.  * @property {boolean} restrictToElementSize
  2388.  *   If true, restrict the quality to media element size.
  2389.  *   Note: The use of ResizeObserver is required for it to work properly. If
  2390.  *   true without ResizeObserver, it behaves as false.
  2391.  *   <br>
  2392.  *   Defaults to <code>false</code>.
  2393.  * @property {boolean} restrictToScreenSize
  2394.  *   If true, restrict the quality to screen size.
  2395.  *   <br>
  2396.  *   Defaults to <code>false</code>.
  2397.  * @property {boolean} ignoreDevicePixelRatio
  2398.  *   If true,device pixel ratio is ignored when restricting the quality to
  2399.  *   media element size or screen size.
  2400.  *   <br>
  2401.  *   Defaults to <code>false</code>.
  2402.  * @property {boolean} clearBufferSwitch
  2403.  *   If true, the buffer will be cleared during the switch.
  2404.  *   The default automatic behavior is false to have a smoother transition.
  2405.  *   On some device it's better to clear buffer.
  2406.  *   <br>
  2407.  *   Defaults to <code>false</code>.
  2408.  * @property {number} safeMarginSwitch
  2409.  *   Optional amount of buffer (in seconds) to
  2410.  *   retain when clearing the buffer during the automatic switch.
  2411.  *   Useful for switching variant quickly without causing a buffering event.
  2412.  *   Ignored if clearBuffer is false.
  2413.  *   Can cause hiccups on some browsers if chosen too small, e.g.
  2414.  *   The amount of two segments is a fair minimum to consider as safeMargin
  2415.  *   value.
  2416.  *   <br>
  2417.  *   Defaults to <code>o</code>.
  2418.  * @property {number} cacheLoadThreshold
  2419.  *   Indicates the value in milliseconds from which a request is not
  2420.  *   considered cached.
  2421.  *   <br>
  2422.  *   Defaults to <code>20</code>.
  2423.  * @property {number} minTimeToSwitch
  2424.  *   Indicates the minimum time to change quality once the real bandwidth is
  2425.  *   available, in seconds. This time is only used on the first load.
  2426.  *   <br>
  2427.  *   Defaults to <code>0</code> seconds except in Apple browsers whose default
  2428.  *   value  is <code>0.5</code> seconds.
  2429.  * @property {boolean} preferNetworkInformationBandwidth
  2430.  *   If true, use the Network Information API bandwidth estimation in the
  2431.  *   current AbrManager, if it is available in the browser environment. This
  2432.  *   way Shaka Player will never estimate the bandwidth and we will always
  2433.  *   trust the information provided by the browser.
  2434.  *   <br>
  2435.  *   Defaults to <code>false</code>.
  2436.  * @property {boolean} removeLatencyFromFirstPacketTime
  2437.  *   If true, we remove the latency from first packet time. This time is
  2438.  *   used to calculate the real bandwidth.
  2439.  *   <br>
  2440.  *   Defaults to <code>true</code>.
  2441.  * @exportDoc
  2442.  */
  2443. shaka.extern.AbrConfiguration;
  2446. /**
  2447.  * @typedef {{
  2448.  *   minTotalBytes: number,
  2449.  *   minBytes: number,
  2450.  *   fastHalfLife: number,
  2451.  *   slowHalfLife: number
  2452.  * }}
  2453.  *
  2454.  * @property {number} minTotalBytes
  2455.  *   Minimum number of bytes sampled before we trust the estimate.  If we have
  2456.  *   not sampled much data, our estimate may not be accurate enough to trust.
  2457.  *   <br>
  2458.  *   Defaults to <code>128e3</code>.
  2459.  * @property {number} minBytes
  2460.  *   Minimum number of bytes, under which samples are discarded.  Our models
  2461.  *   do not include latency information, so connection startup time (time to
  2462.  *   first byte) is considered part of the download time.  Because of this, we
  2463.  *   should ignore very small downloads which would cause our estimate to be
  2464.  *   too low.
  2465.  *   <br>
  2466.  *   Defaults to <code>16e3</code>.
  2467.  * @property {number} fastHalfLife
  2468.  *   The quantity of prior samples (by weight) used when creating a new
  2469.  *   estimate, in seconds.  Those prior samples make up half of the
  2470.  *   new estimate.
  2471.  *   <br>
  2472.  *   Defaults to <code>2</code>.
  2473.  * @property {number} slowHalfLife
  2474.  *   The quantity of prior samples (by weight) used when creating a new
  2475.  *   estimate, in seconds.  Those prior samples make up half of the
  2476.  *   new estimate.
  2477.  *   <br>
  2478.  *   Defaults to <code>5</code>.
  2479.  * @exportDoc
  2480.  */
  2481. shaka.extern.AdvancedAbrConfiguration;
  2484. /**
  2485.  * @typedef {{
  2486.  *   enabled: boolean,
  2487.  *   useHeaders: boolean,
  2488.  *   sessionId: string,
  2489.  *   contentId: string,
  2490.  *   rtpSafetyFactor: number,
  2491.  *   includeKeys: !Array<string>,
  2492.  *   version: number
  2493.  * }}
  2494.  *
  2495.  * @description
  2496.  *   Common Media Client Data (CMCD) configuration.
  2497.  *
  2498.  * @property {boolean} enabled
  2499.  *   If <code>true</code>, enable CMCD data to be sent with media requests.
  2500.  *   <br>
  2501.  *   Defaults to <code>false</code>.
  2502.  * @property {boolean} useHeaders
  2503.  *   If <code>true</code>, send CMCD data using the header transmission mode
  2504.  *   instead of query args.
  2505.  *   <br>
  2506.  *   Defaults to <code>false</code>.
  2507.  * @property {string} sessionId
  2508.  *   A GUID identifying the current playback session. A playback session
  2509.  *   typically ties together segments belonging to a single media asset.
  2510.  *   Maximum length is 64 characters. It is RECOMMENDED to conform to the UUID
  2511.  *   specification.
  2512.  *   <br>
  2513.  *   By default the sessionId is automatically generated on each
  2514.  *   <code>load()</code> call.
  2515.  * @property {string} contentId
  2516.  *   A unique string identifying the current content. Maximum length is 64
  2517.  *   characters. This value is consistent across multiple different sessions and
  2518.  *   devices and is defined and updated at the discretion of the service
  2519.  *   provider.
  2520.  *   <br>
  2521.  *   Defaults to <code>'false'</code>.
  2522.  * @property {number} rtpSafetyFactor
  2523.  *   RTP safety factor.
  2524.  *   <br>
  2525.  *   Defaults to <code>5</code>.
  2526.  * @property {!Array<string>} includeKeys
  2527.  *   An array of keys to include in the CMCD data. If not provided, all keys
  2528.  *   will be included.
  2529.  *   <br>
  2530.  *   Defaults to <code>[]</code>.
  2531.  * @property {number} version
  2532.  *   The CMCD version.
  2533.  *   Valid values are <code>1</code> or <code>2</code>, corresponding to CMCD v1
  2534.  *   and CMCD v2 specifications, respectively.
  2535.  *   <br>
  2536.  *   Defaults to <code>1</code>.
  2537.  * @exportDoc
  2538.  */
  2539. shaka.extern.CmcdConfiguration;
  2542. /**
  2543.  * @typedef {{
  2544.  *   enabled: boolean,
  2545.  *   applyMaximumSuggestedBitrate: boolean,
  2546.  *   estimatedThroughputWeightRatio: number
  2547.  * }}
  2548.  *
  2549.  * @description
  2550.  *   Common Media Server Data (CMSD) configuration.
  2551.  *
  2552.  * @property {boolean} enabled
  2553.  *   If <code>true</code>, enables reading CMSD data in media requests.
  2554.  *   <br>
  2555.  *   Defaults to <code>true</code>.
  2556.  * @property {boolean} applyMaximumSuggestedBitrate
  2557.  *   If true, we must apply the maximum suggested bitrate. If false, we ignore
  2558.  *   this.
  2559.  *   <br>
  2560.  *   Defaults to <code>true</code>.
  2561.  * @property {number} estimatedThroughputWeightRatio
  2562.  *   How much the estimatedThroughput of the CMSD data should be weighted
  2563.  *   against the default estimate, between 0 and 1.
  2564.  *   <br>
  2565.  *   Defaults to <code>0.5</code>.
  2566.  * @exportDoc
  2567.  */
  2568. shaka.extern.CmsdConfiguration;
  2570. /**
  2571.  * @typedef {{
  2572.  *   enabled: boolean,
  2573.  *   dynamicPerformanceScaling: boolean,
  2574.  *   logLevel: number,
  2575.  *   drawLogo: boolean,
  2576.  *   poster: boolean
  2577.  * }}
  2578.  *
  2579.  * @description
  2580.  *   Decoding for MPEG-5 Part2 LCEVC.
  2581.  *
  2582.  * @property {boolean} enabled
  2583.  *   If <code>true</code>, enable LCEVC.
  2584.  *   Defaults to <code>false</code>.
  2585.  * @property {boolean} dynamicPerformanceScaling
  2586.  *   If <code>true</code>, LCEVC Dynamic Performance Scaling or dps is enabled
  2587.  *   to be triggered, when the system is not able to decode frames within a
  2588.  *   specific tolerance of the fps of the video and disables LCEVC decoding
  2589.  *   for some time. The base video will be shown upscaled to target resolution.
  2590.  *   If it is triggered again within a short period of time, the disabled
  2591.  *   time will be higher and if it is triggered three times in a row the LCEVC
  2592.  *   decoding will be disabled for that playback session.
  2593.  *   If dynamicPerformanceScaling is false, LCEVC decode will be forced
  2594.  *   and will drop frames appropriately if performance is sub optimal.
  2595.  *   <br>
  2596.  *   Defaults to <code>true</code>.
  2597.  * @property {number} logLevel
  2598.  *   Loglevel 0-5 for logging.
  2599.  *   NONE = 0
  2600.  *   ERROR = 1
  2601.  *   WARNING = 2
  2602.  *   INFO = 3
  2603.  *   DEBUG = 4
  2604.  *   VERBOSE = 5
  2605.  *   <br>
  2606.  *   Defaults to <code>0</code>.
  2607.  * @property {boolean} drawLogo
  2608.  *   If <code>true</code>, LCEVC Logo is placed on the top left hand corner
  2609.  *   which only appears when the LCEVC enhanced frames are being rendered.
  2610.  *   Defaults to true for the lib but is forced to false in this integration
  2611.  *   unless explicitly set to true through config.
  2612.  *   <br>
  2613.  *   Defaults to <code>false</code>.
  2614.  * @property {boolean} poster
  2615.  *   If <code>true</code>, render a poster frame before the video is started.
  2616.  *   Defaults to true for the lib and set to true in the integration.
  2617.  *   <br>
  2618.  *   Defaults to <code>true</code>.
  2619.  * @exportDoc
  2620.  */
  2621. shaka.extern.LcevcConfiguration;
  2623. /**
  2624.  * @typedef {{
  2625.  *   trackSelectionCallback:
  2626.  *       function(shaka.extern.TrackList):!Promise<shaka.extern.TrackList>,
  2627.  *   downloadSizeCallback: function(number):!Promise<boolean>,
  2628.  *   progressCallback: function(shaka.extern.StoredContent,number),
  2629.  *   usePersistentLicense: boolean,
  2630.  *   numberOfParallelDownloads: number
  2631.  * }}
  2632.  *
  2633.  * @property {function(shaka.extern.TrackList):
  2634.  *              !Promise<shaka.extern.TrackList>} trackSelectionCallback
  2635.  *   Called inside <code>store()</code> to determine which tracks to save from a
  2636.  *   manifest. It is passed an array of Tracks from the manifest and it should
  2637.  *   return an array of the tracks to store.
  2638.  * @property {function(number):!Promise<boolean>} downloadSizeCallback
  2639.  *   Called inside <code>store()</code> to determine if the content can be
  2640.  *   downloaded due to its estimated size. The estimated size of the download is
  2641.  *   passed and it must return if the download is allowed or not.
  2642.  * @property {function(shaka.extern.StoredContent,number)} progressCallback
  2643.  *   Called inside <code>store()</code> to give progress info back to the app.
  2644.  *   It is given the current manifest being stored and the progress of it being
  2645.  *   stored.
  2646.  * @property {boolean} usePersistentLicense
  2647.  *   If <code>true</code>, store protected content with a persistent license so
  2648.  *   that no network is required to view.
  2649.  *   If <code>false</code>, store protected content without a persistent
  2650.  *   license.  A network will be required to retrieve a temporary license to
  2651.  *   view.
  2652.  *   <br>
  2653.  *   Defaults to <code>true</code>.
  2654.  * @property {number} numberOfParallelDownloads
  2655.  *   Number of parallel downloads. If the value is 0, downloads will be
  2656.  *   sequential for each stream.
  2657.  *   Note: normally browsers limit to 5 request in parallel, so putting a
  2658.  *   number higher than this will not help it download faster.
  2659.  *   <br>
  2660.  *   Defaults to <code>5</code>.
  2661.  * @exportDoc
  2662.  */
  2663. shaka.extern.OfflineConfiguration;
  2666. /**
  2667.  * @typedef {{
  2668.  *   captionsUpdatePeriod: number,
  2669.  *   fontScaleFactor: number
  2670.  * }}
  2671.  *
  2672.  * @description
  2673.  *   Text displayer configuration.
  2674.  *
  2675.  * @property {number} captionsUpdatePeriod
  2676.  *   The number of seconds to see if the captions should be updated.
  2677.  *   <br>
  2678.  *   Defaults to <code>0.25</code>.
  2679.  * @property {number} fontScaleFactor
  2680.  *   The font scale factor used to increase or decrease the font size.
  2681.  *   <br>
  2682.  *   Defaults to <code>1</code>.
  2683.  * @exportDoc
  2684.  */
  2685. shaka.extern.TextDisplayerConfiguration;
  2688. /**
  2689.  * @typedef {{
  2690.  *   ads: shaka.extern.AdsConfiguration,
  2691.  *   autoShowText: shaka.config.AutoShowText,
  2692.  *   drm: shaka.extern.DrmConfiguration,
  2693.  *   manifest: shaka.extern.ManifestConfiguration,
  2694.  *   streaming: shaka.extern.StreamingConfiguration,
  2695.  *   networking: shaka.extern.NetworkingConfiguration,
  2696.  *   mediaSource: shaka.extern.MediaSourceConfiguration,
  2697.  *   abrFactory: shaka.extern.AbrManager.Factory,
  2698.  *   adaptationSetCriteriaFactory: shaka.media.AdaptationSetCriteria.Factory,
  2699.  *   abr: shaka.extern.AbrConfiguration,
  2700.  *   cmcd: shaka.extern.CmcdConfiguration,
  2701.  *   cmsd: shaka.extern.CmsdConfiguration,
  2702.  *   lcevc: shaka.extern.LcevcConfiguration,
  2703.  *   offline: shaka.extern.OfflineConfiguration,
  2704.  *   ignoreHardwareResolution: boolean,
  2705.  *   preferredAudioLanguage: string,
  2706.  *   preferredAudioLabel: string,
  2707.  *   preferredTextLanguage: string,
  2708.  *   preferredVariantRole: string,
  2709.  *   preferredTextRole: string,
  2710.  *   preferredVideoCodecs: !Array<string>,
  2711.  *   preferredAudioCodecs: !Array<string>,
  2712.  *   preferredTextFormats: !Array<string>,
  2713.  *   preferredAudioChannelCount: number,
  2714.  *   preferredVideoHdrLevel: string,
  2715.  *   preferredVideoLayout: string,
  2716.  *   preferredVideoLabel: string,
  2717.  *   preferredDecodingAttributes: !Array<string>,
  2718.  *   preferForcedSubs: boolean,
  2719.  *   preferSpatialAudio: boolean,
  2720.  *   queue: shaka.extern.QueueConfiguration,
  2721.  *   restrictions: shaka.extern.Restrictions,
  2722.  *   playRangeStart: number,
  2723.  *   playRangeEnd: number,
  2724.  *   textDisplayer: shaka.extern.TextDisplayerConfiguration,
  2725.  *   textDisplayFactory: shaka.extern.TextDisplayer.Factory
  2726.  * }}
  2727.  *
  2728.  * @property {shaka.extern.AdsConfiguration} ads
  2729.  *   Ads configuration and settings.
  2730.  * @property {shaka.config.AutoShowText} autoShowText
  2731.  *   Controls behavior of auto-showing text tracks on load().
  2732.  *   <br>
  2733.  *   Defaults to
  2734.  *   {@link shaka.config.AutoShowText#IF_SUBTITLES_MAY_BE_NEEDED}.
  2735.  * @property {shaka.extern.DrmConfiguration} drm
  2736.  *   DRM configuration and settings.
  2737.  * @property {shaka.extern.ManifestConfiguration} manifest
  2738.  *   Manifest configuration and settings.
  2739.  * @property {shaka.extern.StreamingConfiguration} streaming
  2740.  *   Streaming configuration and settings.
  2741.  * @property {shaka.extern.NetworkingConfiguration} networking
  2742.  *   Networking configuration and settings.
  2743.  * @property {shaka.extern.MediaSourceConfiguration} mediaSource
  2744.  *   Media source configuration and settings.
  2745.  * @property {shaka.extern.AbrManager.Factory} abrFactory
  2746.  *   A factory to construct an abr manager.
  2747.  * @property {shaka.media.AdaptationSetCriteria.Factory
  2748.  *           } adaptationSetCriteriaFactory
  2749.  *   A factory to construct an adaptation set criteria.
  2750.  * @property {shaka.extern.AbrConfiguration} abr
  2751.  *   ABR configuration and settings.
  2752.  * @property {shaka.extern.CmcdConfiguration} cmcd
  2753.  *   CMCD configuration and settings. (Common Media Client Data)
  2754.  * @property {shaka.extern.CmsdConfiguration} cmsd
  2755.  *   CMSD configuration and settings. (Common Media Server Data)
  2756.  * @property {shaka.extern.LcevcConfiguration} lcevc
  2757.  *   MPEG-5 LCEVC configuration and settings.
  2758.  *   (Low Complexity Enhancement Video Codec)
  2759.  * @property {shaka.extern.OfflineConfiguration} offline
  2760.  *   Offline configuration and settings.
  2761.  * @property {boolean} ignoreHardwareResolution
  2762.  *   Do not detect the hardware resolution.  For some niche cases where content
  2763.  *   is only available at resolutions beyond the device's native resolution,
  2764.  *   and you are confident it can be decoded and downscaled, this flag can
  2765.  *   allow playback when it would otherwise fail.
  2766.  * @property {string} preferredAudioLanguage
  2767.  *   The preferred language to use for audio tracks.  If not given it will use
  2768.  *   the <code>'main'</code> track.
  2769.  *   Changing this during playback will not affect the current playback.
  2770.  *   <br>
  2771.  *   Defaults to <code>''</code>.
  2772.  * @property {string} preferredAudioLabel
  2773.  *   The preferred label to use for audio tracks.
  2774.  *   <br>
  2775.  *   Defaults to <code>''</code>.
  2776.  * @property {string} preferredVideoLabel
  2777.  *   The preferred label to use for video tracks.
  2778.  *   <br>
  2779.  *   Defaults to <code>''</code>.
  2780.  * @property {string} preferredTextLanguage
  2781.  *   The preferred language to use for text tracks.  If a matching text track
  2782.  *   is found, and the selected audio and text tracks have different languages,
  2783.  *   the text track will be shown.
  2784.  *   Changing this during playback will not affect the current playback.
  2785.  *   <br>
  2786.  *   Defaults to <code>''</code>.
  2787.  * @property {string} preferredVariantRole
  2788.  *   The preferred role to use for variants.
  2789.  *   <br>
  2790.  *   Defaults to <code>''</code>.
  2791.  * @property {string} preferredTextRole
  2792.  *   The preferred role to use for text tracks.
  2793.  *   <br>
  2794.  *   Defaults to <code>''</code>.
  2795.  * @property {!Array<string>} preferredVideoCodecs
  2796.  *   The list of preferred video codecs, in order of highest to lowest priority.
  2797.  *   This is used to do a filtering of the variants available for the player.
  2798.  *   <br>
  2799.  *   Defaults to <code>[]</code>.
  2800.  * @property {!Array<string>} preferredAudioCodecs
  2801.  *   The list of preferred audio codecs, in order of highest to lowest priority.
  2802.  *   This is used to do a filtering of the variants available for the player.
  2803.  *   <br>
  2804.  *   Defaults to <code>[]</code>.
  2805.  * @property {!Array<string>} preferredTextFormats
  2806.  *   The list of preferred text formats, in order of highest to lowest priority.
  2807.  *   This is used to do a filtering of the text tracks available for the player.
  2808.  *   <br>
  2809.  *   Defaults to <code>[]</code>.
  2810.  * @property {number} preferredAudioChannelCount
  2811.  *   The preferred number of audio channels.
  2812.  *   <br>
  2813.  *   Defaults to <code>2</code>.
  2814.  * @property {string} preferredVideoHdrLevel
  2815.  *   The preferred HDR level of the video. If possible, this will cause the
  2816.  *   player to filter to assets that either have that HDR level, or no HDR level
  2817.  *   at all.
  2818.  *   Can be 'SDR', 'PQ', 'HLG', 'AUTO' for auto-detect, or '' for no preference.
  2819.  *   Note that one some platforms, such as Chrome, attempting to play PQ content
  2820.  *   may cause problems.
  2821.  *   <br>
  2822.  *   Defaults to <code>'AUTO'</code>.
  2823.  * @property {string} preferredVideoLayout
  2824.  *   The preferred video layout of the video.
  2825.  *   Can be 'CH-STEREO', 'CH-MONO', or '' for no preference.
  2826.  *   If the content is predominantly stereoscopic you should use 'CH-STEREO'.
  2827.  *   If the content is predominantly monoscopic you should use 'CH-MONO'.
  2828.  *   <br>
  2829.  *   Defaults to <code>''</code>.
  2830.  * @property {!Array<string>} preferredDecodingAttributes
  2831.  *   The list of preferred attributes of decodingInfo, in the order of their
  2832.  *   priorities.
  2833.  *   This is used to do a filtering of the variants available for the player.
  2834.  *   <br>
  2835.  *   Defaults to <code>[]</code>.
  2836.  * @property {boolean} preferForcedSubs
  2837.  *   If true, a forced text track is preferred.
  2838.  *   If the content has no forced captions and the value is true,
  2839.  *   no text track is chosen.
  2840.  *   Changing this during playback will not affect the current playback.
  2841.  *   <br>
  2842.  *   Defaults to <code>false</code>.
  2843.  * @property {boolean} preferSpatialAudio
  2844.  *   If true, a spatial audio track is preferred.
  2845.  *   <br>
  2846.  *   Defaults to <code>false</code>.
  2847.  * @property {shaka.extern.QueueConfiguration} queue
  2848.  *   Queue manager configuration and settings.
  2849.  * @property {shaka.extern.Restrictions} restrictions
  2850.  *   The application restrictions to apply to the tracks.  These are "hard"
  2851.  *   restrictions.  Any track that fails to meet these restrictions will not
  2852.  *   appear in the track list.  If no tracks meet these restrictions, playback
  2853.  *   will fail.
  2854.  * @property {number} playRangeStart
  2855.  *   Optional playback and seek start time in seconds. Defaults to 0 if
  2856.  *   not provided.
  2857.  *   <br>
  2858.  *   Defaults to <code>0</code>.
  2859.  * @property {number} playRangeEnd
  2860.  *   Optional playback and seek end time in seconds. Defaults to the end of
  2861.  *   the presentation if not provided.
  2862.  *   <br>
  2863.  *   Defaults to <code>Infinity</code>.
  2864.  * @property {shaka.extern.TextDisplayerConfiguration} textDisplayer
  2865.  *   Text displayer configuration and settings.
  2866.  * @property {shaka.extern.TextDisplayer.Factory} textDisplayFactory
  2867.  *   A factory to construct a text displayer. Note that, if this is changed
  2868.  *   during playback, it will cause the text tracks to be reloaded.
  2869.  * @exportDoc
  2870.  */
  2871. shaka.extern.PlayerConfiguration;
  2874. /**
  2875.  * @typedef {{
  2876.  *   preloadNextUrlWindow: number,
  2877.  *   repeatMode: shaka.config.RepeatMode
  2878.  * }}
  2879.  *
  2880.  * @description
  2881.  * The Queue Manager's configuration options.
  2882.  *
  2883.  * @property {number} preloadNextUrlWindow
  2884.  *   The window of time at the end of the presentation to begin preloading the
  2885.  *   next item. Measured in seconds. If the value is 0, the next URL will not
  2886.  *   be preloaded at all.
  2887.  *   <br>
  2888.  *   Defaults to <code>30</code>.
  2889.  * @property {shaka.config.RepeatMode} repeatMode
  2890.  *   Controls behavior of the queue when all items have been played.
  2891.  *   <br>
  2892.  *   Defaults to {@link shaka.config.RepeatMode#OFF}.
  2893.  * @exportDoc
  2894.  */
  2895. shaka.extern.QueueConfiguration;
  2898. /**
  2899.  * @typedef {{
  2900.  *   language: string,
  2901.  *   role: string,
  2902.  *   label: ?string
  2903.  * }}
  2904.  *
  2905.  * @property {string} language
  2906.  *    The language code for the stream.
  2907.  * @property {string} role
  2908.  *    The role name for the stream. If the stream has no role, <code>role</code>
  2909.  *    will be <code>''</code>.
  2910.  * @property {?string} label
  2911.  *    The label of the audio stream, if it has one.
  2912.  * @exportDoc
  2913.  */
  2914. shaka.extern.LanguageRole;
  2917. /**
  2918.  * @typedef {{
  2919.  *   segment: shaka.media.SegmentReference,
  2920.  *   imageHeight: number,
  2921.  *   imageWidth: number,
  2922.  *   height: number,
  2923.  *   positionX: number,
  2924.  *   positionY: number,
  2925.  *   startTime: number,
  2926.  *   duration: number,
  2927.  *   uris: !Array<string>,
  2928.  *   startByte: number,
  2929.  *   endByte: ?number,
  2930.  *   width: number,
  2931.  *   sprite: boolean,
  2932.  *   mimeType: ?string,
  2933.  *   codecs: ?string
  2934.  * }}
  2935.  *
  2936.  * @property {shaka.media.SegmentReference} segment
  2937.  *    The segment of this thumbnail.
  2938.  * @property {number} imageHeight
  2939.  *    The image height in px. The image height could be different to height if
  2940.  *    the layout is different to 1x1.
  2941.  * @property {number} imageWidth
  2942.  *    The image width in px. The image width could be different to width if
  2943.  *    the layout is different to 1x1.
  2944.  * @property {number} height
  2945.  *    The thumbnail height in px.
  2946.  * @property {number} positionX
  2947.  *    The thumbnail left position in px.
  2948.  * @property {number} positionY
  2949.  *    The thumbnail top position in px.
  2950.  * @property {number} startTime
  2951.  *    The start time of the thumbnail in the presentation timeline, in seconds.
  2952.  * @property {number} duration
  2953.  *    The duration of the thumbnail, in seconds.
  2954.  * @property {!Array<string>} uris
  2955.  *   An array of URIs to attempt.  They will be tried in the order they are
  2956.  *   given.
  2957.  * @property {number} startByte
  2958.  *   The offset from the start of the uri resource.
  2959.  * @property {?number} endByte
  2960.  *   The offset from the start of the resource to the end of the segment,
  2961.  *   inclusive.  A value of null indicates that the segment extends to the end
  2962.  *   of the resource.
  2963.  * @property {number} width
  2964.  *    The thumbnail width in px.
  2965.  * @property {boolean} sprite
  2966.  *    Indicate if the thumbnail is a sprite.
  2967.  * @property {?string} mimeType
  2968.  *   The thumbnail MIME type, if present.
  2969.  * @property {?string} codecs
  2970.  *   The thumbnail codecs, if present.
  2971.  * @exportDoc
  2972.  */
  2973. shaka.extern.Thumbnail;
  2976. /**
  2977.  * @typedef {{
  2978.  *   id: string,
  2979.  *   title: string,
  2980.  *   startTime: number,
  2981.  *   endTime: number
  2982.  * }}
  2983.  *
  2984.  * @property {string} id
  2985.  *    The id of the chapter.
  2986.  * @property {string} title
  2987.  *    The title of the chapter.
  2988.  * @property {number} startTime
  2989.  *    The time that describes the beginning of the range of the chapter.
  2990.  * @property {number} endTime
  2991.  *    The time that describes the end of the range of chapter.
  2992.  * @exportDoc
  2993.  */
  2994. shaka.extern.Chapter;
  2997. /**
  2998.  * @typedef {{
  2999.  *   uri: string,
  3000.  *   language: string,
  3001.  *   kind: string,
  3002.  *   mime: string,
  3003.  *   codecs: (string|undefined)
  3004.  * }}
  3005.  *
  3006.  * @property {string} uri
  3007.  *   The URI of the text.
  3008.  * @property {string} language
  3009.  *   The language of the text (e.g. 'en').
  3010.  * @property {string} kind
  3011.  *   The kind of text (e.g. 'subtitles').
  3012.  * @property {?string} mime
  3013.  *   The MIME type of the text (e.g. 'text/vtt')
  3014.  * @property {?string} codecs
  3015.  *   The codecs string, if needed to refine the MIME type.
  3016.  * @exportDoc
  3017.  */
  3018. shaka.extern.ExtraText;
  3021. /**
  3022.  * @typedef {{
  3023.  *   uri: string,
  3024.  *   language: string,
  3025.  *   mime: string
  3026.  * }}
  3027.  *
  3028.  * @property {string} uri
  3029.  *   The URI of the chapter.
  3030.  * @property {string} language
  3031.  *   The language of the chapter (e.g. 'en').
  3032.  * @property {string} mime
  3033.  *   The MIME type of the chapter (e.g. 'text/vtt')
  3034.  */
  3035. shaka.extern.ExtraChapter;