shaka-player 4.3.10 → 4.4.0

package/lib/cea/cea_utils.js

@@ -7,7 +7,6 @@
 goog.provide('shaka.cea.CeaUtils');
 goog.provide('shaka.cea.CeaUtils.StyledChar');
 
-goog.require('shaka.cea.ICaptionDecoder');
 goog.require('shaka.text.Cue');
 
 
@@ -19,7 +18,7 @@ shaka.cea.CeaUtils = class {
    * @param {!Array<!Array<?shaka.cea.CeaUtils.StyledChar>>} memory
    * @param {number} startTime Start time of the cue.
    * @param {number} endTime End time of the cue.
-   * @return {?shaka.cea.ICaptionDecoder.ClosedCaption}
+   * @return {?shaka.extern.ICaptionDecoder.ClosedCaption}
    */
   static getParsedCaption(topLevelCue, stream, memory, startTime, endTime) {
     if (startTime >= endTime) {
@@ -270,3 +269,27 @@ shaka.cea.CeaUtils.DEFAULT_BG_COLOR = 'black';
  * @const {string}
  */
 shaka.cea.CeaUtils.DEFAULT_TXT_COLOR = 'white';
+
+/**
+ * NALU type for Supplemental Enhancement Information (SEI) for H.264.
+ * @const {number}
+ */
+shaka.cea.CeaUtils.H264_NALU_TYPE_SEI = 0x06;
+
+/**
+ * NALU type for Supplemental Enhancement Information (SEI) for H.265.
+ * @const {number}
+ */
+shaka.cea.CeaUtils.H265_PREFIX_NALU_TYPE_SEI = 0x27;
+
+/**
+ * NALU type for Supplemental Enhancement Information (SEI) for H.265.
+ * @const {number}
+ */
+shaka.cea.CeaUtils.H265_SUFFIX_NALU_TYPE_SEI = 0x28;
+
+/**
+ * Default timescale value for a track.
+ * @const {number}
+ */
+shaka.cea.CeaUtils.DEFAULT_TIMESCALE_VALUE = 90000;

package/lib/cea/dummy_caption_decoder.js

@@ -0,0 +1,21 @@
+/*! @license
+ * Shaka Player
+ * Copyright 2016 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+goog.provide('shaka.cea.DummyCaptionDecoder');
+
+/** @implements {shaka.extern.ICaptionDecoder} */
+shaka.cea.DummyCaptionDecoder = class {
+  /** @override */
+  extract(userDataSeiMessage, pts) {}
+
+  /** @override */
+  decode() {
+    return [];
+  }
+
+  /** @override */
+  clear() {}
+};

package/lib/cea/dummy_cea_parser.js

@@ -6,11 +6,9 @@
 
 goog.provide('shaka.cea.DummyCeaParser');
 
-goog.require('shaka.cea.ICeaParser');
-
 /**
  * Dummy CEA parser.
- * @implements {shaka.cea.ICeaParser}
+ * @implements {shaka.extern.ICeaParser}
  */
 shaka.cea.DummyCeaParser = class {
   /**

package/lib/cea/mp4_cea_parser.js

@@ -7,9 +7,10 @@
 goog.provide('shaka.cea.Mp4CeaParser');
 
 goog.require('goog.asserts');
-goog.require('shaka.cea.ICeaParser');
+goog.require('shaka.cea.CeaUtils');
 goog.require('shaka.cea.SeiProcessor');
 goog.require('shaka.log');
+goog.require('shaka.media.ClosedCaptionParser');
 goog.require('shaka.util.DataViewReader');
 goog.require('shaka.util.Error');
 goog.require('shaka.util.Mp4Parser');
@@ -17,7 +18,8 @@ goog.require('shaka.util.Mp4BoxParsers');
 
 /**
  * MPEG4 stream parser used for extracting 708 closed captions data.
- * @implements {shaka.cea.ICeaParser}
+ * @implements {shaka.extern.ICeaParser}
+ * @export
  */
 shaka.cea.Mp4CeaParser = class {
   /** */
@@ -157,7 +159,7 @@ shaka.cea.Mp4CeaParser = class {
       return [];
     }
 
-    /** @type {!Array<!shaka.cea.ICeaParser.CaptionPacket>} **/
+    /** @type {!Array<!shaka.extern.ICeaParser.CaptionPacket>} **/
     const captionPackets = [];
 
     // Fields that are found in MOOF boxes
@@ -167,7 +169,7 @@ shaka.cea.Mp4CeaParser = class {
     /** @type {!Array<shaka.util.ParsedTRUNBox>} */
     let parsedTRUNs = [];
     let baseMediaDecodeTime = null;
-    let timescale = shaka.cea.ICeaParser.DEFAULT_TIMESCALE_VALUE;
+    let timescale = shaka.cea.CeaUtils.DEFAULT_TIMESCALE_VALUE;
 
     new Mp4Parser()
         .box('moof', (box) => {
@@ -214,7 +216,7 @@ shaka.cea.Mp4CeaParser = class {
               box.version != null,
               'TFDT is a full box and should have a valid version.');
 
-          const parsedTFDT = shaka.util.Mp4BoxParsers.parseTFDT(
+          const parsedTFDT = shaka.util.Mp4BoxParsers.parseTFDTInaccurate(
               box.reader, box.version);
 
           baseMediaDecodeTime = parsedTFDT.baseMediaDecodeTime;
@@ -250,13 +252,13 @@ shaka.cea.Mp4CeaParser = class {
    * @param {number} defaultSampleSize
    * @param {number} offset
    * @param {!Array<shaka.util.ParsedTRUNBox>} parsedTRUNs
-   * @param {!Array<!shaka.cea.ICeaParser.CaptionPacket>} captionPackets
+   * @param {!Array<!shaka.extern.ICeaParser.CaptionPacket>} captionPackets
    * @private
    */
   parseMdat_(reader, time, timescale, defaultSampleDuration,
       defaultSampleSize, offset, parsedTRUNs, captionPackets) {
     const BitstreamFormat = shaka.cea.Mp4CeaParser.BitstreamFormat;
-    const ICeaParser = shaka.cea.ICeaParser;
+    const CeaUtils = shaka.cea.CeaUtils;
     let sampleIndex = 0;
 
     // The fields in each ParsedTRUNSample contained in the sampleData
@@ -288,7 +290,7 @@ shaka.cea.Mp4CeaParser = class {
       switch (this.bitstreamFormat_) {
         case BitstreamFormat.H264:
           naluType = naluHeader & 0x1f;
-          isSeiMessage = naluType == ICeaParser.H264_NALU_TYPE_SEI;
+          isSeiMessage = naluType == CeaUtils.H264_NALU_TYPE_SEI;
           break;
 
         case BitstreamFormat.H265:
@@ -296,8 +298,8 @@ shaka.cea.Mp4CeaParser = class {
           reader.skip(1);
           naluType = (naluHeader >> 1) & 0x3f;
           isSeiMessage =
-              naluType == ICeaParser.H265_PREFIX_NALU_TYPE_SEI ||
-              naluType == ICeaParser.H265_SUFFIX_NALU_TYPE_SEI;
+              naluType == CeaUtils.H265_PREFIX_NALU_TYPE_SEI ||
+              naluType == CeaUtils.H265_SUFFIX_NALU_TYPE_SEI;
           break;
 
         default:
@@ -376,3 +378,6 @@ shaka.cea.Mp4CeaParser.CodecBitstreamMap_ = {
   'dvh1': shaka.cea.Mp4CeaParser.BitstreamFormat.H265,
   'dvhe': shaka.cea.Mp4CeaParser.BitstreamFormat.H265,
 };
+
+shaka.media.ClosedCaptionParser.registerParser('video/mp4',
+    () => new shaka.cea.Mp4CeaParser());

package/lib/cea/ts_cea_parser.js

@@ -0,0 +1,69 @@
+/*! @license
+ * Shaka Player
+ * Copyright 2016 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+goog.provide('shaka.cea.TsCeaParser');
+
+goog.require('shaka.cea.CeaUtils');
+goog.require('shaka.cea.SeiProcessor');
+goog.require('shaka.media.ClosedCaptionParser');
+goog.require('shaka.util.BufferUtils');
+goog.require('shaka.util.TsParser');
+
+/**
+ * MPEG TS CEA parser.
+ * @implements {shaka.extern.ICeaParser}
+ * @export
+ */
+shaka.cea.TsCeaParser = class {
+  /** */
+  constructor() {
+    /**
+     * SEI data processor.
+     * @private
+     * @const {!shaka.cea.SeiProcessor}
+     */
+    this.seiProcessor_ = new shaka.cea.SeiProcessor();
+  }
+
+  /**
+   * @override
+   */
+  init(initSegment) {
+    // TS hasn't init segment
+  }
+
+  /**
+   * @override
+   */
+  parse(mediaSegment) {
+    const CeaUtils = shaka.cea.CeaUtils;
+
+    /** @type {!Array<!shaka.extern.ICeaParser.CaptionPacket>} **/
+    const captionPackets = [];
+
+    const uint8ArrayData = shaka.util.BufferUtils.toUint8(mediaSegment);
+    if (!shaka.util.TsParser.probe(uint8ArrayData)) {
+      return captionPackets;
+    }
+    const tsParser = new shaka.util.TsParser().parse(uint8ArrayData);
+    const videoNalus = tsParser.getVideoNalus();
+    for (const nalu of videoNalus) {
+      if (nalu.type == CeaUtils.H264_NALU_TYPE_SEI &&
+          nalu.time != null) {
+        for (const packet of this.seiProcessor_.process(nalu.data)) {
+          captionPackets.push({
+            packet: packet,
+            pts: nalu.time,
+          });
+        }
+      }
+    }
+    return captionPackets;
+  }
+};
+
+shaka.media.ClosedCaptionParser.registerParser('video/mp2t',
+    () => new shaka.cea.TsCeaParser());

package/lib/dash/content_protection.js

@@ -166,12 +166,19 @@ shaka.dash.ContentProtection = class {
 
   /**
    * Gets a Widevine license URL from a content protection element
-   * containing a custom `ms:laurl` element
+   * containing a custom `ms:laurl` or 'dashif:Laurl' elements
    *
    * @param {shaka.dash.ContentProtection.Element} element
    * @return {string}
    */
   static getWidevineLicenseUrl(element) {
+    const dashIfLaurlNode = shaka.util.XmlUtils.findChildNS(
+        element.node, shaka.dash.ContentProtection.DashIfNamespaceUri_,
+        'Laurl',
+    );
+    if (dashIfLaurlNode && dashIfLaurlNode.textContent) {
+      return dashIfLaurlNode.textContent;
+    }
     const mslaurlNode = shaka.util.XmlUtils.findChildNS(
         element.node, 'urn:microsoft', 'laurl');
     if (mslaurlNode) {
@@ -182,12 +189,19 @@ shaka.dash.ContentProtection = class {
 
   /**
    * Gets a ClearKey license URL from a content protection element
-   * containing a custom `clearkey::Laurl` element
+   * containing a custom `clearkey::Laurl` or 'dashif:Laurl' elements
    *
    * @param {shaka.dash.ContentProtection.Element} element
    * @return {string}
    */
   static getClearKeyLicenseUrl(element) {
+    const dashIfLaurlNode = shaka.util.XmlUtils.findChildNS(
+        element.node, shaka.dash.ContentProtection.DashIfNamespaceUri_,
+        'Laurl',
+    );
+    if (dashIfLaurlNode && dashIfLaurlNode.textContent) {
+      return dashIfLaurlNode.textContent;
+    }
     const clearKeyLaurlNode = shaka.util.XmlUtils.findChildNS(
         element.node, shaka.dash.ContentProtection.ClearKeyNamespaceUri_,
         'Laurl',
@@ -307,6 +321,14 @@ shaka.dash.ContentProtection = class {
    * @return {string}
    */
   static getPlayReadyLicenseUrl(element) {
+    const dashIfLaurlNode = shaka.util.XmlUtils.findChildNS(
+        element.node, shaka.dash.ContentProtection.DashIfNamespaceUri_,
+        'Laurl',
+    );
+    if (dashIfLaurlNode && dashIfLaurlNode.textContent) {
+      return dashIfLaurlNode.textContent;
+    }
+
     const proNode = shaka.util.XmlUtils.findChildNS(
         element.node, 'urn:microsoft:playready', 'pro');
 
@@ -657,3 +679,11 @@ shaka.dash.ContentProtection.ClearKeyNamespaceUri_ =
  */
 shaka.dash.ContentProtection.ClearKeySchemeUri_ =
     'urn:uuid:e2719d58-a985-b3c9-781a-b030af78d30e';
+
+
+/**
+ * @const {string}
+ * @private
+ */
+shaka.dash.ContentProtection.DashIfNamespaceUri_ =
+  'https://dashif.org/CPS';

package/lib/dash/dash_parser.js

@@ -19,7 +19,6 @@ goog.require('shaka.media.PresentationTimeline');
 goog.require('shaka.media.SegmentIndex');
 goog.require('shaka.net.NetworkingEngine');
 goog.require('shaka.text.TextEngine');
-goog.require('shaka.util.CmcdManager');
 goog.require('shaka.util.Error');
 goog.require('shaka.util.Functional');
 goog.require('shaka.util.LanguageUtils');
@@ -222,15 +221,12 @@ shaka.dash.DashParser = class {
    */
   async requestManifest_() {
     const requestType = shaka.net.NetworkingEngine.RequestType.MANIFEST;
+    const type = shaka.net.NetworkingEngine.AdvancedRequestType.MPD;
     const request = shaka.net.NetworkingEngine.makeRequest(
         this.manifestUris_, this.config_.retryParameters);
     const networkingEngine = this.playerInterface_.networkingEngine;
-
-    const format = shaka.util.CmcdManager.StreamingFormat.DASH;
-    this.playerInterface_.modifyManifestRequest(request, {format: format});
-
     const startTime = Date.now();
-    const operation = networkingEngine.request(requestType, request);
+    const operation = networkingEngine.request(requestType, request, {type});
     this.operationManager_.manage(operation);
 
     const response = await operation.promise;
@@ -489,6 +485,18 @@ shaka.dash.DashParser = class {
 
     await this.periodCombiner_.combinePeriods(periods, context.dynamic);
 
+    // Set minBufferTime to 0 for low-latency DASH live stream to achieve the
+    // best latency
+    if (this.lowLatencyMode_) {
+      minBufferTime = 0;
+    }
+
+    // Set updatePeriod_ to minTotalAvailabilityTimeOffset_ to achieve the best
+    // latency in LL streams
+    if (this.lowLatencyMode_ && this.minTotalAvailabilityTimeOffset_) {
+      this.updatePeriod_ = this.minTotalAvailabilityTimeOffset_;
+    }
+
     // These steps are not done on manifest update.
     if (!this.manifest_) {
       this.manifest_ = {
@@ -499,6 +507,9 @@ shaka.dash.DashParser = class {
         offlineSessionIds: [],
         minBufferTime: minBufferTime || 0,
         sequenceMode: this.config_.dash.sequenceMode,
+        ignoreManifestTimestampsInSegmentsMode: false,
+        type: shaka.media.ManifestParser.DASH,
+        serviceDescription: this.parseServiceDescription_(mpd),
       };
 
       // We only need to do clock sync when we're using presentation start
@@ -537,6 +548,39 @@ shaka.dash.DashParser = class {
     this.playerInterface_.makeTextStreamsForClosedCaptions(this.manifest_);
   }
 
+  /**
+   * Reads maxLatency and maxPlaybackRate properties from service
+   * description element.
+   *
+   * @param {!Element} mpd
+   * @return {?shaka.extern.ServiceDescription}
+   * @private
+   */
+  parseServiceDescription_(mpd) {
+    const XmlUtils = shaka.util.XmlUtils;
+    const elem = XmlUtils.findChild(mpd, 'ServiceDescription');
+
+    if (!elem ) {
+      return null;
+    }
+
+    const latencyNode = XmlUtils.findChild(elem, 'Latency');
+    const playbackRateNode = XmlUtils.findChild(elem, 'PlaybackRate');
+
+    if ((latencyNode && latencyNode.getAttribute('max')) || playbackRateNode) {
+      const maxLatency = latencyNode && latencyNode.getAttribute('max') ?
+        parseInt(latencyNode.getAttribute('max'), 10) / 1000 :
+        null;
+      const maxPlaybackRate = playbackRateNode ?
+        parseFloat(playbackRateNode.getAttribute('max')) :
+        null;
+
+      return {maxLatency, maxPlaybackRate};
+    }
+
+    return null;
+  }
+
   /**
    * Reads and parses the periods from the manifest.  This first does some
    * partial parsing so the start and duration is available when parsing
@@ -546,7 +590,7 @@ shaka.dash.DashParser = class {
    * @param {!Array.<string>} baseUris
    * @param {!Element} mpd
    * @return {{
-   *   periods: !Array.<shaka.util.PeriodCombiner.Period>,
+   *   periods: !Array.<shaka.extern.Period>,
    *   duration: ?number,
    *   durationDerivedFromPeriods: boolean
    * }}
@@ -698,7 +742,7 @@ shaka.dash.DashParser = class {
    * @param {shaka.dash.DashParser.Context} context
    * @param {!Array.<string>} baseUris
    * @param {shaka.dash.DashParser.PeriodInfo} periodInfo
-   * @return {shaka.util.PeriodCombiner.Period}
+   * @return {shaka.extern.Period}
    * @private
    */
   parsePeriod_(context, baseUris, periodInfo) {
@@ -950,6 +994,8 @@ shaka.dash.DashParser = class {
     const accessibilities = XmlUtils.findChildren(elem, 'Accessibility');
     const LanguageUtils = shaka.util.LanguageUtils;
     const closedCaptions = new Map();
+    /** @type {?shaka.media.ManifestParser.AccessibilityPurpose} */
+    let accessibilityPurpose;
     for (const prop of accessibilities) {
       const schemeId = prop.getAttribute('schemeIdUri');
       const value = prop.getAttribute('value');
@@ -1032,6 +1078,15 @@ shaka.dash.DashParser = class {
             kind = ManifestParserUtils.TextStreamKind.CLOSED_CAPTION;
           }
         }
+      } else if (schemeId == 'urn:tva:metadata:cs:AudioPurposeCS:2007') {
+        // See DASH DVB Document A168 Rev.6 Table 5.
+        if (value == '1') {
+          accessibilityPurpose =
+              shaka.media.ManifestParser.AccessibilityPurpose.VISUALLY_IMPAIRED;
+        } else if (value == '2') {
+          accessibilityPurpose =
+              shaka.media.ManifestParser.AccessibilityPurpose.HARD_OF_HEARING;
+        }
       }
     }
 
@@ -1053,8 +1108,8 @@ shaka.dash.DashParser = class {
         this.config_.dash.ignoreDrmInfo,
         this.config_.dash.keySystemsByURI);
 
-    const language =
-        shaka.util.LanguageUtils.normalize(elem.getAttribute('lang') || 'und');
+    const language = shaka.util.LanguageUtils.normalize(
+        context.adaptationSet.language || 'und');
 
     // This attribute is currently non-standard, but it is supported by Kaltura.
     let label = elem.getAttribute('label');
@@ -1074,7 +1129,7 @@ shaka.dash.DashParser = class {
     const streams = representations.map((representation) => {
       const parsedRepresentation = this.parseRepresentation_(context,
           contentProtection, kind, language, label, main, roleValues,
-          closedCaptions, representation);
+          closedCaptions, representation, accessibilityPurpose);
       if (parsedRepresentation) {
         parsedRepresentation.hdr = parsedRepresentation.hdr || videoRange;
       }
@@ -1150,12 +1205,15 @@ shaka.dash.DashParser = class {
    * @param {!Array.<string>} roles
    * @param {Map.<string, string>} closedCaptions
    * @param {!Element} node
+   * @param {?shaka.media.ManifestParser.AccessibilityPurpose}
+   *   accessibilityPurpose
+   *
    * @return {?shaka.extern.Stream} The Stream, or null when there is a
    *   non-critical parsing error.
    * @private
    */
   parseRepresentation_(context, contentProtection, kind, language, label,
-      isPrimary, roles, closedCaptions, node) {
+      isPrimary, roles, closedCaptions, node, accessibilityPurpose) {
     const XmlUtils = shaka.util.XmlUtils;
     const ContentType = shaka.util.ManifestParserUtils.ContentType;
 
@@ -1189,12 +1247,12 @@ shaka.dash.DashParser = class {
     const isImage = contentType == ContentType.IMAGE;
 
     try {
-      const requestInitSegment = (uris, startByte, endByte) => {
-        return this.requestInitSegment_(uris, startByte, endByte);
+      const requestSegment = (uris, startByte, endByte, isInit) => {
+        return this.requestSegment_(uris, startByte, endByte, isInit);
       };
       if (context.representation.segmentBase) {
         streamInfo = shaka.dash.SegmentBase.createStreamInfo(
-            context, requestInitSegment);
+            context, requestSegment);
       } else if (context.representation.segmentList) {
         streamInfo = shaka.dash.SegmentList.createStreamInfo(
             context, this.streamMap_);
@@ -1202,7 +1260,7 @@ shaka.dash.DashParser = class {
         const hasManifest = !!this.manifest_;
 
         streamInfo = shaka.dash.SegmentTemplate.createStreamInfo(
-            context, requestInitSegment, this.streamMap_, hasManifest,
+            context, requestSegment, this.streamMap_, hasManifest,
             this.config_.dash.initialSegmentLimit, this.periodDurations_);
       } else {
         goog.asserts.assert(isText,
@@ -1322,6 +1380,7 @@ shaka.dash.DashParser = class {
         drmInfos: contentProtection.drmInfos,
         keyIds,
         language,
+        originalLanguage: context.adaptationSet.language,
         label,
         type: context.adaptationSet.contentType,
         primary: isPrimary,
@@ -1337,6 +1396,7 @@ shaka.dash.DashParser = class {
         hdr,
         tilesLayout,
         matchedStreams: [],
+        accessibilityPurpose,
         external: false,
       };
     }
@@ -1378,6 +1438,10 @@ shaka.dash.DashParser = class {
 
       // Try updating again, but ensure we haven't been destroyed.
       if (this.playerInterface_) {
+        if (this.config_.raiseFatalErrorOnManifestUpdateRequestFailure) {
+          this.playerInterface_.onError(error);
+          return;
+        }
         // We will retry updating, so override the severity of the error.
         error.severity = shaka.util.Error.Severity.RECOVERABLE;
         this.playerInterface_.onError(error);
@@ -1410,7 +1474,6 @@ shaka.dash.DashParser = class {
     }
 
     const finalDelay = Math.max(
-        shaka.dash.DashParser.MIN_UPDATE_PERIOD_,
         this.updatePeriod_ - offset,
         this.averageUpdateDuration_.getEstimate());
 
@@ -1508,6 +1571,7 @@ shaka.dash.DashParser = class {
       pixelAspectRatio: pixelAspectRatio,
       emsgSchemeIdUris: emsgSchemeIdUris,
       id: elem.getAttribute('id'),
+      language: elem.getAttribute('lang'),
       numChannels: numChannels,
       audioSamplingRate: audioSamplingRate,
       availabilityTimeOffset: availabilityTimeOffset,
@@ -1846,11 +1910,15 @@ shaka.dash.DashParser = class {
    * @param {!Array.<string>} uris
    * @param {?number} startByte
    * @param {?number} endByte
+   * @param {boolean} isInit
    * @return {!Promise.<BufferSource>}
    * @private
    */
-  async requestInitSegment_(uris, startByte, endByte) {
+  async requestSegment_(uris, startByte, endByte, isInit) {
     const requestType = shaka.net.NetworkingEngine.RequestType.SEGMENT;
+    const type = isInit ?
+        shaka.net.NetworkingEngine.AdvancedRequestType.INIT_SEGMENT :
+        shaka.net.NetworkingEngine.AdvancedRequestType.MEDIA_SEGMENT;
 
     const request = shaka.util.Networking.createSegmentRequest(
         uris,
@@ -1859,7 +1927,7 @@ shaka.dash.DashParser = class {
         this.config_.retryParameters);
 
     const networkingEngine = this.playerInterface_.networkingEngine;
-    const operation = networkingEngine.request(requestType, request);
+    const operation = networkingEngine.request(requestType, request, {type});
     this.operationManager_.manage(operation);
     const response = await operation.promise;
     return response.data;
@@ -1890,22 +1958,13 @@ shaka.dash.DashParser = class {
 };
 
 
-/**
- * Contains the minimum amount of time, in seconds, between manifest update
- * requests.
- *
- * @private
- * @const {number}
- */
-shaka.dash.DashParser.MIN_UPDATE_PERIOD_ = 3;
-
-
 /**
  * @typedef {
- *   function(!Array.<string>, ?number, ?number):!Promise.<BufferSource>
+ *   function(!Array.<string>, ?number, ?number, boolean):
+ *     !Promise.<BufferSource>
  * }
  */
-shaka.dash.DashParser.RequestInitSegmentCallback;
+shaka.dash.DashParser.RequestSegmentCallback;
 
 
 /**
@@ -1923,6 +1982,7 @@ shaka.dash.DashParser.RequestInitSegmentCallback;
  *   pixelAspectRatio: (string|undefined),
  *   emsgSchemeIdUris: !Array.<string>,
  *   id: ?string,
+ *   language: ?string,
  *   numChannels: ?number,
  *   audioSamplingRate: ?number,
  *   availabilityTimeOffset: number
@@ -1958,6 +2018,8 @@ shaka.dash.DashParser.RequestInitSegmentCallback;
  *   emsg registered schemeIdUris.
  * @property {?string} id
  *   The ID of the element.
+ * @property {?string} language
+ *   The original language of the element.
  * @property {?number} numChannels
  *   The number of audio channels, or null if unknown.
  * @property {?number} audioSamplingRate

package/lib/dash/mpd_utils.js

@@ -15,6 +15,7 @@ goog.require('shaka.util.Functional');
 goog.require('shaka.util.ManifestParserUtils');
 goog.require('shaka.util.XmlUtils');
 goog.requireType('shaka.dash.DashParser');
+goog.requireType('shaka.media.PresentationTimeline');
 
 
 /**
@@ -121,7 +122,7 @@ shaka.dash.MpdUtils = class {
    * @param {number} unscaledPresentationTimeOffset
    * @param {number} periodDuration The Period's duration in seconds.
    *   Infinity indicates that the Period continues indefinitely.
-   * @return {!Array.<shaka.dash.MpdUtils.TimeRange>}
+   * @return {!Array.<shaka.media.PresentationTimeline.TimeRange>}
    */
   static createTimeline(
       segmentTimeline, timescale, unscaledPresentationTimeOffset,
@@ -137,7 +138,7 @@ shaka.dash.MpdUtils = class {
 
     const timePoints = XmlUtils.findChildren(segmentTimeline, 'S');
 
-    /** @type {!Array.<shaka.dash.MpdUtils.TimeRange>} */
+    /** @type {!Array.<shaka.media.PresentationTimeline.TimeRange>} */
     const timeline = [];
     let lastEndTime = -unscaledPresentationTimeOffset;
 
@@ -289,7 +290,7 @@ shaka.dash.MpdUtils = class {
 
     const timelineNode =
         MpdUtils.inheritChild(context, callback, 'SegmentTimeline');
-    /** @type {Array.<shaka.dash.MpdUtils.TimeRange>} */
+    /** @type {Array.<shaka.media.PresentationTimeline.TimeRange>} */
     let timeline = null;
     if (timelineNode) {
       timeline = MpdUtils.createTimeline(
@@ -538,26 +539,6 @@ shaka.dash.MpdUtils = class {
 };
 
 
-/**
- * @typedef {{
- *   start: number,
- *   unscaledStart: number,
- *   end: number
- * }}
- *
- * @description
- * Defines a time range of a media segment.  Times are in seconds.
- *
- * @property {number} start
- *   The start time of the range.
- * @property {number} unscaledStart
- *   The start time of the range in representation timescale units.
- * @property {number} end
- *   The end time (exclusive) of the range.
- */
-shaka.dash.MpdUtils.TimeRange;
-
-
 /**
  * @typedef {{
  *   timescale: number,
@@ -565,7 +546,7 @@ shaka.dash.MpdUtils.TimeRange;
  *   startNumber: number,
  *   scaledPresentationTimeOffset: number,
  *   unscaledPresentationTimeOffset: number,
- *   timeline: Array.<shaka.dash.MpdUtils.TimeRange>
+ *   timeline: Array.<shaka.media.PresentationTimeline.TimeRange>
  * }}
  *
  * @description
@@ -581,7 +562,7 @@ shaka.dash.MpdUtils.TimeRange;
  *   The presentation time offset of the representation, in seconds.
  * @property {number} unscaledPresentationTimeOffset
  *   The presentation time offset of the representation, in timescale units.
- * @property {Array.<shaka.dash.MpdUtils.TimeRange>} timeline
+ * @property {Array.<shaka.media.PresentationTimeline.TimeRange>} timeline
  *   The timeline of the representation, if given.  Times in seconds.
  */
 shaka.dash.MpdUtils.SegmentInfo;