shaka-player 3.3.2 → 4.0.0

package/lib/abr/simple_abr_manager.js

@@ -9,7 +9,6 @@ goog.provide('shaka.abr.SimpleAbrManager');
 goog.require('goog.asserts');
 goog.require('shaka.abr.EwmaBandwidthEstimator');
 goog.require('shaka.log');
-goog.require('shaka.util.Iterables');
 goog.require('shaka.util.StreamUtils');
 
 
@@ -145,15 +144,21 @@ shaka.abr.SimpleAbrManager = class {
     // Start by assuming that we will use the first Stream.
     let chosen = sortedVariants[0] || null;
 
-    const enumerate = (it) => shaka.util.Iterables.enumerate(it);
-    for (const {item, next} of enumerate(sortedVariants)) {
+    for (let i = 0; i < sortedVariants.length; i++) {
+      const item = sortedVariants[i];
       const playbackRate =
           !isNaN(this.playbackRate_) ? Math.abs(this.playbackRate_) : 1;
       const itemBandwidth = playbackRate * item.bandwidth;
       const minBandwidth =
           itemBandwidth / this.config_.bandwidthDowngradeTarget;
-      const nextBandwidth =
-          playbackRate * (next || {bandwidth: Infinity}).bandwidth;
+      let next = {bandwidth: Infinity};
+      for (let j = i + 1; j < sortedVariants.length; j++) {
+        if (item.bandwidth != sortedVariants[j].bandwidth) {
+          next = sortedVariants[j];
+          break;
+        }
+      }
+      const nextBandwidth = playbackRate * next.bandwidth;
       const maxBandwidth = nextBandwidth / this.config_.bandwidthUpgradeTarget;
       shaka.log.v2('Bandwidth ranges:',
           (itemBandwidth / 1e6).toFixed(3),
@@ -161,7 +166,8 @@ shaka.abr.SimpleAbrManager = class {
           (maxBandwidth / 1e6).toFixed(3));
 
       if (currentBandwidth >= minBandwidth &&
-          currentBandwidth <= maxBandwidth) {
+          currentBandwidth <= maxBandwidth &&
+          chosen.bandwidth != item.bandwidth) {
         chosen = item;
       }
     }

package/lib/ads/client_side_ad.js

@@ -18,14 +18,18 @@ shaka.ads.ClientSideAd = class {
   /**
    * @param {!google.ima.Ad} imaAd
    * @param {!google.ima.AdsManager} imaAdManager
+   * @param {HTMLMediaElement} video
    */
-  constructor(imaAd, imaAdManager) {
+  constructor(imaAd, imaAdManager, video) {
     /** @private {google.ima.Ad} */
     this.ad_ = imaAd;
 
     /** @private {google.ima.AdsManager} */
     this.manager_ = imaAdManager;
 
+    /** @private {HTMLMediaElement} */
+    this.video_ = video;
+
     /** @private {boolean} */
     this.isPaused_ = false;
 
@@ -176,7 +180,14 @@ shaka.ads.ClientSideAd = class {
    * @export
    */
   resize(width, height) {
-    const viewMode = document.fullscreenElement ?
+    let isInFullscreen = false;
+    const video = /** @type {HTMLVideoElement} */(this.video_);
+    if (document.fullscreenEnabled) {
+      isInFullscreen = !!document.fullscreenElement;
+    } else if (video.webkitSupportsFullscreen) {
+      isInFullscreen = video.webkitDisplayingFullscreen;
+    }
+    const viewMode = isInFullscreen ?
         google.ima.ViewMode.FULLSCREEN : google.ima.ViewMode.NORMAL;
     this.manager_.resize(width, height, viewMode);
   }

package/lib/ads/client_side_ad_manager.js

@@ -181,7 +181,7 @@ shaka.ads.ClientSideAdManager = class {
     this.addImaEventListeners_();
 
     try {
-      const viewMode = document.fullscreenElement ?
+      const viewMode = this.isFullScreenEnabled_() ?
           google.ima.ViewMode.FULLSCREEN : google.ima.ViewMode.NORMAL;
 
       this.imaAdsManager_.init(this.video_.offsetWidth,
@@ -191,7 +191,7 @@ shaka.ads.ClientSideAdManager = class {
       // because 'loadedmetadata' is sometimes called before the video resizes
       // on some platforms (e.g. Safari).
       this.eventManager_.listen(this.video_, 'loadeddata', () => {
-        const viewMode = document.fullscreenElement ?
+        const viewMode = this.isFullScreenEnabled_() ?
             google.ima.ViewMode.FULLSCREEN : google.ima.ViewMode.NORMAL;
         this.imaAdsManager_.resize(this.video_.offsetWidth,
             this.video_.offsetHeight, viewMode);
@@ -199,7 +199,7 @@ shaka.ads.ClientSideAdManager = class {
 
       if ('ResizeObserver' in window) {
         this.resizeObserver_ = new ResizeObserver(() => {
-          const viewMode = document.fullscreenElement ?
+          const viewMode = this.isFullScreenEnabled_() ?
               google.ima.ViewMode.FULLSCREEN : google.ima.ViewMode.NORMAL;
           this.imaAdsManager_.resize(this.video_.offsetWidth,
               this.video_.offsetHeight, viewMode);
@@ -221,6 +221,23 @@ shaka.ads.ClientSideAdManager = class {
   }
 
 
+  /**
+   * @return {boolean}
+   * @private
+   */
+  isFullScreenEnabled_() {
+    if (document.fullscreenEnabled) {
+      return !!document.fullscreenElement;
+    } else {
+      const video = /** @type {HTMLVideoElement} */(this.video_);
+      if (video.webkitSupportsFullscreen) {
+        return video.webkitDisplayingFullscreen;
+      }
+    }
+    return false;
+  }
+
+
   /**
    * @private
    */
@@ -389,7 +406,8 @@ shaka.ads.ClientSideAdManager = class {
         'Should have an ads manager at this point!');
 
     const imaAd = e.getAd();
-    this.ad_ = new shaka.ads.ClientSideAd(imaAd, this.imaAdsManager_);
+    this.ad_ = new shaka.ads.ClientSideAd(imaAd,
+        this.imaAdsManager_, this.video_);
     const data = new Map()
         .set('ad', this.ad_)
         .set('sdkAdObject', imaAd)

package/lib/cast/cast_proxy.js

@@ -314,10 +314,9 @@ shaka.cast.CastProxy = class extends shaka.util.FakeEventTarget {
    * @private
    */
   mapCompiledToUncompiledPlayerMethodNames_() {
-    // In compiled mode, UI tries to access player methods
-    // by their internal renamed names, but the proxy object doesn't know about
-    // those.
-    // See https://github.com/google/shaka-player/issues/2130 for details.
+    // In compiled mode, UI tries to access player methods by their internal
+    // renamed names, but the proxy object doesn't know about those.  See
+    // https://github.com/shaka-project/shaka-player/issues/2130 for details.
     const methodsToNames = new Map();
     this.iterateOverPlayerMethods_((name, method) => {
       if (methodsToNames.has(method)) {

package/lib/cast/cast_utils.js

@@ -373,7 +373,6 @@ shaka.cast.CastUtils.PlayerInitAfterLoadState = [
  */
 shaka.cast.CastUtils.PlayerVoidMethods = [
   'addChaptersTrack',
-  'addTextTrack',
   'addTextTrackAsync',
   'cancelTrickPlay',
   'configure',

package/lib/cea/cea608_data_channel.js

@@ -140,8 +140,8 @@ shaka.cea.Cea608DataChannel = class {
     const buf = this.curbuf_;
 
     // Move entire scroll window to a new base in rollup mode.
-    if (this.type_ === shaka.cea.Cea608DataChannel.CaptionType.ROLLUP
-        && row !== buf.getRow()) {
+    if (this.type_ === shaka.cea.Cea608DataChannel.CaptionType.ROLLUP &&
+        row !== buf.getRow()) {
       const oldTopRow = 1 + buf.getRow() - buf.getScrollSize();
       const newTopRow = 1 + row - buf.getScrollSize();
 

package/lib/cea/cea708_service.js

@@ -9,7 +9,6 @@ goog.provide('shaka.cea.Cea708Service');
 goog.require('shaka.cea.Cea708Window');
 goog.require('shaka.cea.DtvccPacket');
 goog.require('shaka.cea.ICaptionDecoder');
-goog.require('shaka.util.Error');
 
 
 /**
@@ -301,17 +300,19 @@ shaka.cea.Cea708Service = class {
   /**
    * Yields each non-null window specified in the 8-bit bitmap.
    * @param {number} bitmap 8 bits corresponding to each of the 8 windows.
-   * @return {!Iterable.<number>}
+   * @return {!Array.<number>}
    * @private
    */
-  * getSpecifiedWindowIds_(bitmap) {
+  getSpecifiedWindowIds_(bitmap) {
+    const ids = [];
     for (let i = 0; i < 8; i++) {
       const windowSpecified = (bitmap & 0x01) === 0x01;
       if (windowSpecified && this.windows_[i]) {
-        yield i;
+        ids.push(i);
       }
       bitmap >>= 1;
     }
+    return ids;
   }
 
   /**

package/lib/cea/mp4_cea_parser.js

@@ -150,11 +150,11 @@ shaka.cea.Mp4CeaParser = class {
 
           // If specified, defaultSampleDuration and defaultSampleSize
           // override the ones specified in the TREX box
-          defaultSampleDuration = parsedTFHD.defaultSampleDuration
-            || this.defaultSampleDuration_;
+          defaultSampleDuration = parsedTFHD.defaultSampleDuration ||
+              this.defaultSampleDuration_;
 
-          defaultSampleSize = parsedTFHD.defaultSampleSize
-            || this.defaultSampleSize_;
+          defaultSampleSize = parsedTFHD.defaultSampleSize ||
+              this.defaultSampleSize_;
 
           const trackId = parsedTFHD.trackId;
 
@@ -236,7 +236,13 @@ shaka.cea.Mp4CeaParser = class {
           });
         }
       } else {
-        reader.skip(naluSize - 1);
+        try {
+          reader.skip(naluSize - 1);
+        } catch (e) {
+          // It is necessary to ignore this error because it can break the start
+          // of playback even if the user does not want to see the subtitles.
+          break;
+        }
       }
       sampleSize -= (naluSize + 4);
       if (sampleSize == 0) {

package/lib/cea/sei_processor.js

@@ -14,9 +14,10 @@ shaka.cea.SeiProcessor = class {
   /**
    * Processes supplemental enhancement information data.
    * @param {!Uint8Array} naluData NALU from which SEI data is to be processed.
-   * @return {!Iterable.<!Uint8Array>}
+   * @return {!Array.<!Uint8Array>}
    */
-  * process(naluData) {
+  process(naluData) {
+    const seiPayloads = [];
     const naluClone = this.removeEmu(naluData);
 
     // The following is an implementation of section 7.3.2.3.1
@@ -41,10 +42,12 @@ shaka.cea.SeiProcessor = class {
       // Payload type 4 is user_data_registered_itu_t_t35, as per the H.264
       // spec. This payload type contains caption data.
       if (payloadType == 0x04) {
-        yield naluClone.subarray(offset, offset + payloadSize);
+        seiPayloads.push(naluClone.subarray(offset, offset + payloadSize));
       }
       offset += payloadSize;
     }
+
+    return seiPayloads;
   }
 
 

package/lib/dash/content_protection.js

@@ -68,7 +68,7 @@ shaka.dash.ContentProtection = class {
 
       if (parsedNonCenc.length) {
         drmInfos = ContentProtection.convertElements_(
-            defaultInit, parsedNonCenc, keySystemsByURI);
+            defaultInit, parsedNonCenc, keySystemsByURI, keyIds);
 
         // If there are no drmInfos after parsing, then add a dummy entry.
         // This may be removed in parseKeyIds.
@@ -180,6 +180,27 @@ shaka.dash.ContentProtection = class {
     return '';
   }
 
+  /**
+   * Gets a ClearKey license URL from a content protection element
+   * containing a custom `clearkey::Laurl` element
+   *
+   * @param {shaka.dash.ContentProtection.Element} element
+   * @return {string}
+   */
+  static getClearKeyLicenseUrl(element) {
+    const clearKeyLaurlNode = shaka.util.XmlUtils.findChildNS(
+        element.node, shaka.dash.ContentProtection.ClearKeyNamespaceUri_,
+        'Laurl',
+    );
+    if (clearKeyLaurlNode &&
+      clearKeyLaurlNode.getAttribute('Lic_type') === 'EME-1.0') {
+      if (clearKeyLaurlNode.textContent) {
+        return clearKeyLaurlNode.textContent;
+      }
+    }
+    return '';
+  }
+
   /**
    * Parses an Array buffer starting at byteOffset for PlayReady Object Records.
    * Each PRO Record is preceded by its PlayReady Record type and length in
@@ -335,7 +356,41 @@ shaka.dash.ContentProtection = class {
       0x9a, 0x04, 0xf0, 0x79, 0x98, 0x40, 0x42, 0x86,
       0xab, 0x92, 0xe6, 0x5b, 0xe0, 0x88, 0x5f, 0x95,
     ]);
-    const pssh = shaka.util.Pssh.createPssh(data, systemId);
+    const keyIds = new Set();
+    const psshVersion = 0;
+    const pssh =
+        shaka.util.Pssh.createPssh(data, systemId, keyIds, psshVersion);
+    return [
+      {
+        initData: pssh,
+        initDataType: 'cenc',
+        keyId: element.keyId,
+      },
+    ];
+  }
+
+  /**
+   * Creates ClearKey initData from Default_KID value retrieved from previously
+   * parsed ContentProtection tag.
+   * @param {shaka.dash.ContentProtection.Element} element
+   * @param {!Set.<string>} keyIds
+   * @return {?Array.<shaka.extern.InitDataOverride>}
+   * @private
+   */
+  static getInitDataClearKey_(element, keyIds) {
+    if (keyIds.size == 0) {
+      return null;
+    }
+
+    const systemId = new Uint8Array([
+      0x10, 0x77, 0xef, 0xec, 0xc0, 0xb2, 0x4d, 0x02,
+      0xac, 0xe3, 0x3c, 0x1e, 0x52, 0xe2, 0xfb, 0x4b,
+    ]);
+    const data = new Uint8Array([]);
+    const psshVersion = 1;
+    const pssh =
+         shaka.util.Pssh.createPssh(data, systemId, keyIds, psshVersion);
+
     return [
       {
         initData: pssh,
@@ -351,10 +406,11 @@ shaka.dash.ContentProtection = class {
    * @param {Array.<shaka.extern.InitDataOverride>} defaultInit
    * @param {!Array.<shaka.dash.ContentProtection.Element>} elements
    * @param {!Object.<string, string>} keySystemsByURI
+   * @param {!Set.<string>} keyIds
    * @return {!Array.<shaka.extern.DrmInfo>}
    * @private
    */
-  static convertElements_(defaultInit, elements, keySystemsByURI) {
+  static convertElements_(defaultInit, elements, keySystemsByURI, keyIds) {
     const ContentProtection = shaka.dash.ContentProtection;
     const ManifestParserUtils = shaka.util.ManifestParserUtils;
     const licenseUrlParsers = ContentProtection.licenseUrlParsers_;
@@ -370,7 +426,14 @@ shaka.dash.ContentProtection = class {
             'Init data must be null or non-empty.');
 
         const proInitData = ContentProtection.getInitDataFromPro_(element);
-        const initData = element.init || defaultInit || proInitData;
+        let clearKeyInitData = null;
+        if (element.schemeUri ===
+              shaka.dash.ContentProtection.ClearKeySchemeUri_) {
+          clearKeyInitData =
+            ContentProtection.getInitDataClearKey_(element, keyIds);
+        }
+        const initData = element.init || defaultInit || proInitData ||
+          clearKeyInitData;
         const info = ManifestParserUtils.createDrmInfo(keySystem, initData);
         const licenseParser = licenseUrlParsers.get(keySystem);
         if (licenseParser) {
@@ -562,7 +625,9 @@ shaka.dash.ContentProtection.licenseUrlParsers_ = new Map()
     .set('com.microsoft.playready.software',
         shaka.dash.ContentProtection.getPlayReadyLicenseUrl)
     .set('com.microsoft.playready.hardware',
-        shaka.dash.ContentProtection.getPlayReadyLicenseUrl);
+        shaka.dash.ContentProtection.getPlayReadyLicenseUrl)
+    .set('org.w3.clearkey',
+        shaka.dash.ContentProtection.getClearKeyLicenseUrl);
 
 /**
  * @const {string}
@@ -577,3 +642,18 @@ shaka.dash.ContentProtection.MP4Protection_ =
  * @private
  */
 shaka.dash.ContentProtection.CencNamespaceUri_ = 'urn:mpeg:cenc:2013';
+
+/**
+ * @const {string}
+ * @private
+ */
+shaka.dash.ContentProtection.ClearKeyNamespaceUri_ =
+  'http://dashif.org/guidelines/clearKey';
+
+
+/**
+ * @const {string}
+ * @private
+ */
+shaka.dash.ContentProtection.ClearKeySchemeUri_ =
+    'urn:uuid:e2719d58-a985-b3c9-781a-b030af78d30e';

package/lib/dash/dash_parser.js

@@ -22,7 +22,6 @@ goog.require('shaka.text.TextEngine');
 goog.require('shaka.util.CmcdManager');
 goog.require('shaka.util.Error');
 goog.require('shaka.util.Functional');
-goog.require('shaka.util.Iterables');
 goog.require('shaka.util.LanguageUtils');
 goog.require('shaka.util.ManifestParserUtils');
 goog.require('shaka.util.MimeUtils');
@@ -104,7 +103,7 @@ shaka.dash.DashParser = class {
 
     /**
      * Period IDs seen in previous manifest.
-     * @private {!Array.<number>}
+     * @private {!Array.<string>}
      */
     this.lastManifestUpdatePeriodIds_ = [];
 
@@ -383,7 +382,7 @@ shaka.dash.DashParser = class {
       // This gives us confidence that our state is maintained correctly, and
       // that the complex logic of multi-Period eviction and period-flattening
       // is correct.  See also:
-      // https://github.com/google/shaka-player/issues/3169#issuecomment-823580634
+      // https://github.com/shaka-project/shaka-player/issues/3169#issuecomment-823580634
       for (const stream of Object.values(this.streamMap_)) {
         if (stream.segmentIndex) {
           stream.segmentIndex.evict(
@@ -499,6 +498,7 @@ shaka.dash.DashParser = class {
         imageStreams: this.periodCombiner_.getImageStreams(),
         offlineSessionIds: [],
         minBufferTime: minBufferTime || 0,
+        sequenceMode: false,
       };
 
       // We only need to do clock sync when we're using presentation start
@@ -555,10 +555,9 @@ shaka.dash.DashParser = class {
     const periods = [];
     let prevEnd = 0;
     const periodNodes = XmlUtils.findChildren(mpd, 'Period');
-    // This uses a for-loop rather than a for-of loop because this needs to look
-    // ahead to the next element.
-    const enumerate = (it) => shaka.util.Iterables.enumerate(it);
-    for (const {i, item: elem, next} of enumerate(periodNodes)) {
+    for (let i = 0; i < periodNodes.length; i++) {
+      const elem = periodNodes[i];
+      const next = periodNodes[i + 1];
       const start = /** @type {number} */ (
         XmlUtils.parseAttr(elem, 'start', XmlUtils.parseDuration, prevEnd));
       const periodId = elem.id;
@@ -764,7 +763,7 @@ shaka.dash.DashParser = class {
           for (const stream of normalSet.streams) {
             // There may be multiple trick mode streams, but we do not
             // currently support that.  Just choose one.
-            // TODO: https://github.com/google/shaka-player/issues/1528
+            // TODO: https://github.com/shaka-project/shaka-player/issues/1528
             stream.trickModeVideo = trickModeSet.streams.find((trickStream) =>
               shaka.util.MimeUtils.getCodecBase(stream.codecs) ==
               shaka.util.MimeUtils.getCodecBase(trickStream.codecs));
@@ -1157,7 +1156,7 @@ shaka.dash.DashParser = class {
     // does not make sense in the DASH spec's bandwidth formulas.
     // In some content, however, the attribute is missing or zero.
     // To avoid NaN at the variant level on broken content, fall back to zero.
-    // https://github.com/google/shaka-player/issues/938#issuecomment-317278180
+    // https://github.com/shaka-project/shaka-player/issues/938#issuecomment-317278180
     context.bandwidth =
         XmlUtils.parseAttr(node, 'bandwidth', XmlUtils.parsePositiveInt) || 0;
 
@@ -1230,13 +1229,12 @@ shaka.dash.DashParser = class {
     });
     let spatialAudio = false;
     if (hasJoc) {
-      context.representation.mimeType = 'audio/eac3-joc';
       spatialAudio = true;
     }
 
     let forced = false;
     if (isText) {
-      // See: https://github.com/google/shaka-player/issues/2122 and
+      // See: https://github.com/shaka-project/shaka-player/issues/2122 and
       // https://github.com/Dash-Industry-Forum/DASH-IF-IOP/issues/165
       forced = roles.includes('forced_subtitle') ||
           roles.includes('forced-subtitle');
@@ -1384,7 +1382,7 @@ shaka.dash.DashParser = class {
     // NOTE: An updatePeriod_ of -1 means the attribute was missing.
     // An attribute which is present and set to 0 should still result in
     // periodic updates.  For more, see:
-    // https://github.com/google/shaka-player/issues/331
+    // https://github.com/shaka-project/shaka-player/issues/331
     if (this.updatePeriod_ < 0) {
       return;
     }

package/lib/dash/mpd_utils.js

@@ -12,7 +12,6 @@ goog.require('shaka.net.NetworkingEngine');
 goog.require('shaka.util.AbortableOperation');
 goog.require('shaka.util.Error');
 goog.require('shaka.util.Functional');
-goog.require('shaka.util.Iterables');
 goog.require('shaka.util.ManifestParserUtils');
 goog.require('shaka.util.XmlUtils');
 goog.requireType('shaka.dash.DashParser');
@@ -142,8 +141,9 @@ shaka.dash.MpdUtils = class {
     const timeline = [];
     let lastEndTime = -unscaledPresentationTimeOffset;
 
-    const enumerate = (it) => shaka.util.Iterables.enumerate(it);
-    for (const {item: timePoint, next} of enumerate(timePoints)) {
+    for (let i = 0; i < timePoints.length; ++i) {
+      const timePoint = timePoints[i];
+      const next = timePoints[i + 1];
       let t = XmlUtils.parseAttr(timePoint, 't', XmlUtils.parseNonNegativeInt);
       const d =
           XmlUtils.parseAttr(timePoint, 'd', XmlUtils.parseNonNegativeInt);
@@ -225,8 +225,7 @@ shaka.dash.MpdUtils = class {
         timeline[timeline.length - 1].end = startTime / timescale;
       }
 
-      for (const _ of shaka.util.Iterables.range(repeat + 1)) {
-        shaka.util.Functional.ignored(_);
+      for (let j = 0; j <= repeat; ++j) {
         const endTime = startTime + d;
         const item = {
           start: startTime / timescale,

package/lib/dash/segment_list.js

@@ -15,7 +15,6 @@ goog.require('shaka.media.SegmentIndex');
 goog.require('shaka.media.SegmentReference');
 goog.require('shaka.util.Error');
 goog.require('shaka.util.Functional');
-goog.require('shaka.util.Iterables');
 goog.require('shaka.util.ManifestParserUtils');
 goog.require('shaka.util.XmlUtils');
 goog.requireType('shaka.dash.DashParser');
@@ -222,7 +221,7 @@ shaka.dash.SegmentList = class {
     /** @type {!Array.<!shaka.media.SegmentReference>} */
     const references = [];
     let prevEndTime = info.startTime;
-    for (const i of shaka.util.Iterables.range(max)) {
+    for (let i = 0; i < max; i++) {
       const segment = info.mediaSegments[i];
       const mediaUri = ManifestParserUtils.resolveUris(
           baseUris, [segment.mediaUri]);

package/lib/dash/segment_template.js

@@ -14,7 +14,6 @@ goog.require('shaka.media.InitSegmentReference');
 goog.require('shaka.media.SegmentIndex');
 goog.require('shaka.media.SegmentReference');
 goog.require('shaka.util.Error');
-goog.require('shaka.util.Iterables');
 goog.require('shaka.util.ManifestParserUtils');
 goog.require('shaka.util.ObjectUtils');
 goog.requireType('shaka.dash.DashParser');
@@ -504,8 +503,9 @@ shaka.dash.SegmentTemplate = class {
 
     /** @type {!Array.<!shaka.media.SegmentReference>} */
     const references = [];
-    const enum_ = (it) => shaka.util.Iterables.enumerate(it);
-    for (const {i, item: {start, unscaledStart, end}} of enum_(info.timeline)) {
+    for (let i = 0; i < info.timeline.length; i++) {
+      const {start, unscaledStart, end} = info.timeline[i];
+
       // Note: i = k - 1, where k indicates the k'th segment listed in the MPD.
       // (See section 5.3.9.5.3 of the DASH spec.)
       const segmentReplacement = i + info.startNumber;