shaka-player 3.3.4 → 4.0.0

package/lib/media/segment_index.js

@@ -9,7 +9,6 @@ goog.provide('shaka.media.SegmentIndex');
 goog.provide('shaka.media.SegmentIterator');
 
 goog.require('goog.asserts');
-goog.require('shaka.Deprecate');
 goog.require('shaka.media.SegmentReference');
 goog.require('shaka.util.IReleasable');
 goog.require('shaka.util.Timer');
@@ -52,23 +51,6 @@ shaka.media.SegmentIndex = class {
   }
 
 
-  /**
-   * SegmentIndex used to be an IDestroyable.  Now it is an IReleasable.
-   * This method is provided for backward compatibility.
-   *
-   * @deprecated
-   * @return {!Promise}
-   * @export
-   */
-  destroy() {
-    shaka.Deprecate.deprecateFeature(4,
-        'shaka.media.SegmentIndex',
-        'Please use release() instead of destroy().');
-    this.release();
-    return Promise.resolve();
-  }
-
-
   /**
    * @override
    * @export
@@ -101,6 +83,17 @@ shaka.media.SegmentIndex = class {
   }
 
 
+  /**
+   * Iterates over all top-level segment references in this segment index.
+   * @param {function(!shaka.media.SegmentReference)} fn
+   */
+  forEachTopLevelReference(fn) {
+    for (const reference of this.references) {
+      fn(reference);
+    }
+  }
+
+
   /**
    * Finds the position of the segment for the given time, in seconds, relative
    * to the start of the presentation.  Returns the position of the segment
@@ -191,9 +184,6 @@ shaka.media.SegmentIndex = class {
    * @param {!Array.<!shaka.media.SegmentReference>} references The list of
    *   SegmentReferences, which must be sorted first by their start times
    *   (ascending) and second by their end times (ascending).
-   * @deprecated Not used directly by our own parsers, so will become private in
-   *   v4.  Use mergeAndEvict() instead.
-   * @export
    */
   merge(references) {
     if (goog.DEBUG) {
@@ -348,7 +338,8 @@ shaka.media.SegmentIndex = class {
             lastReference.appendWindowEnd,
             lastReference.partialReferences,
             lastReference.tilesLayout,
-            lastReference.tileDuration);
+            lastReference.tileDuration,
+            lastReference.syncTime);
   }
 
 
@@ -513,30 +504,6 @@ shaka.media.SegmentIterator = class {
     this.currentPartialPosition_ = partialSegmentIndex;
   }
 
-  /**
-   * Move the iterator to a given timestamp in the underlying SegmentIndex.
-   *
-   * @param {number} time
-   * @return {shaka.media.SegmentReference}
-   * @deprecated Use SegmentIndex.getIteratorForTime instead
-   * @export
-   */
-  seek(time) {
-    shaka.Deprecate.deprecateFeature(
-        4, 'shaka.media.SegmentIterator',
-        'Please use SegmentIndex.getIteratorForTime instead of seek().');
-
-    const iter = this.segmentIndex_.getIteratorForTime(time);
-    if (iter) {
-      this.currentPosition_ = iter.currentPosition_;
-      this.currentPartialPosition_ = iter.currentPartialPosition_;
-    } else {
-      this.currentPosition_ = Number.MAX_VALUE;
-      this.currentPartialPosition_ = 0;
-    }
-    return this.next().value;
-  }
-
   /**
    * @return {shaka.media.SegmentReference}
    * @export

package/lib/media/segment_reference.js

@@ -159,11 +159,18 @@ shaka.media.SegmentReference = class {
    *  The explicit duration of an individual tile within the tiles grid.
    *  If not provided, the duration should be automatically calculated based on
    *  the duration of the reference.
+   * @param {?number=} syncTime
+   *  A time value, expressed in the same scale as the start and end time, which
+   *  is used to synchronize between streams.
+   * @param {shaka.media.SegmentReference.Status=} status
+   *  The segment status is used to indicate that a segment does not exist or is
+   *  not available.
    */
   constructor(
       startTime, endTime, uris, startByte, endByte, initSegmentReference,
       timestampOffset, appendWindowStart, appendWindowEnd,
-      partialReferences = [], tilesLayout = '', tileDuration = null) {
+      partialReferences = [], tilesLayout = '', tileDuration = null,
+      syncTime = null, status = shaka.media.SegmentReference.Status.AVAILABLE) {
     // A preload hinted Partial Segment has the same startTime and endTime.
     goog.asserts.assert(startTime <= endTime,
         'startTime must be less than or equal to endTime');
@@ -213,6 +220,12 @@ shaka.media.SegmentReference = class {
 
     /** @type {?number} */
     this.tileDuration = tileDuration;
+
+    /** @type {?number} */
+    this.syncTime = syncTime;
+
+    /** @type {shaka.media.SegmentReference.Status} */
+    this.status = status;
   }
 
   /**
@@ -308,6 +321,39 @@ shaka.media.SegmentReference = class {
   getTileDuration() {
     return this.tileDuration;
   }
+
+  /**
+   * Returns the segment's status.
+   *
+   * @return {shaka.media.SegmentReference.Status}
+   * @export
+   */
+  getStatus() {
+    return this.status;
+  }
+
+  /**
+   * Mark the reference as unavailable.
+   *
+   * @export
+   */
+  markAsUnavailable() {
+    this.status = shaka.media.SegmentReference.Status.UNAVAILABLE;
+  }
+};
+
+
+/**
+ * Rather than using booleans to communicate what the state of the reference,
+ * we have this enum.
+ *
+ * @enum {number}
+ * @export
+ */
+shaka.media.SegmentReference.Status = {
+  AVAILABLE: 0,
+  UNAVAILABLE: 1,
+  MISSING: 2,
 };
 
 

package/lib/media/streaming_engine.js

@@ -234,7 +234,8 @@ shaka.media.StreamingEngine = class {
 
     const mimeType = shaka.util.MimeUtils.getFullType(
         stream.mimeType, stream.codecs);
-    this.playerInterface_.mediaSourceEngine.reinitText(mimeType);
+    this.playerInterface_.mediaSourceEngine.reinitText(
+        mimeType, this.manifest_.sequenceMode);
 
     const textDisplayer =
         this.playerInterface_.mediaSourceEngine.getTextDisplayer();
@@ -428,7 +429,8 @@ shaka.media.StreamingEngine = class {
       // init segment again.
       const fullMimeType = shaka.util.MimeUtils.getFullType(
           stream.mimeType, stream.codecs);
-      this.playerInterface_.mediaSourceEngine.reinitText(fullMimeType);
+      this.playerInterface_.mediaSourceEngine.reinitText(
+          fullMimeType, this.manifest_.sequenceMode);
     }
 
     // Releases the segmentIndex of the old stream.
@@ -604,11 +606,10 @@ shaka.media.StreamingEngine = class {
    */
   seeked() {
     const presentationTime = this.playerInterface_.getPresentationTime();
-    const smallGapLimit = this.config_.smallGapLimit;
     const ContentType = shaka.util.ManifestParserUtils.ContentType;
     const newTimeIsBuffered = (type) => {
       return this.playerInterface_.mediaSourceEngine.isBuffered(
-          type, presentationTime, smallGapLimit);
+          type, presentationTime);
     };
 
     let streamCleared = false;
@@ -645,6 +646,10 @@ shaka.media.StreamingEngine = class {
         if (type === ContentType.TEXT) {
           this.playerInterface_.mediaSourceEngine.resetCaptionParser();
         }
+
+        // Mark the media state as having seeked, so that the new buffers know
+        // that they will need to be at a new position (for sequence mode).
+        mediaState.seeked = true;
       }
     }
 
@@ -764,7 +769,9 @@ shaka.media.StreamingEngine = class {
     const mediaSourceEngine = this.playerInterface_.mediaSourceEngine;
     const forceTransmuxTS = this.config_.forceTransmuxTS;
 
-    await mediaSourceEngine.init(streamsByType, forceTransmuxTS);
+
+    await mediaSourceEngine.init(streamsByType, forceTransmuxTS,
+        this.manifest_.sequenceMode);
     this.destroyer_.ensureNotDestroyed();
 
     this.setDuration_();
@@ -805,6 +812,9 @@ shaka.media.StreamingEngine = class {
       clearBufferSafeMargin: 0,
       waitingToFlushBuffer: false,
       clearingBuffer: false,
+      // The playhead might be seeking on startup, if a start time is set, so
+      // start "seeked" as true.
+      seeked: true,
       recovering: false,
       hasError: false,
       operation: null,
@@ -1272,6 +1282,7 @@ shaka.media.StreamingEngine = class {
           this.scheduleUpdate_(mediaState, 0);
           return;
         }
+
         await this.append_(
             mediaState, presentationTime, stream, reference, result);
       }
@@ -1508,7 +1519,7 @@ shaka.media.StreamingEngine = class {
 
           await this.playerInterface_.mediaSourceEngine.setStreamProperties(
               mediaState.type, timestampOffset, appendWindowStart,
-              appendWindowEnd);
+              appendWindowEnd, this.manifest_.sequenceMode);
         } catch (error) {
           mediaState.lastAppendWindowStart = null;
           mediaState.lastAppendWindowEnd = null;
@@ -1565,8 +1576,7 @@ shaka.media.StreamingEngine = class {
    * @return {!Promise}
    * @private
    */
-  async append_(mediaState, presentationTime, stream, reference,
-      segment) {
+  async append_(mediaState, presentationTime, stream, reference, segment) {
     const logPrefix = shaka.media.StreamingEngine.logPrefix_(mediaState);
 
     const hasClosedCaptions = stream.closedCaptions &&
@@ -1584,14 +1594,19 @@ shaka.media.StreamingEngine = class {
 
     await this.evict_(mediaState, presentationTime);
     this.destroyer_.ensureNotDestroyed();
-    shaka.log.v1(logPrefix, 'appending media segment');
+    shaka.log.v1(logPrefix, 'appending media segment at',
+        (reference.syncTime == null ? 'unknown' : reference.syncTime));
 
+    const seeked = mediaState.seeked;
+    mediaState.seeked = false;
     await this.playerInterface_.mediaSourceEngine.appendBuffer(
         mediaState.type,
         segment,
-        reference.startTime,
+        reference.syncTime == null ? reference.startTime : reference.syncTime,
         reference.endTime,
-        hasClosedCaptions);
+        hasClosedCaptions,
+        seeked,
+        this.manifest_.sequenceMode);
     this.destroyer_.ensureNotDestroyed();
     shaka.log.v2(logPrefix, 'appended media segment');
   }
@@ -2017,6 +2032,7 @@ shaka.media.StreamingEngine.PlayerInterface;
  *   waitingToFlushBuffer: boolean,
  *   clearBufferSafeMargin: number,
  *   clearingBuffer: boolean,
+ *   seeked: boolean,
  *   recovering: boolean,
  *   hasError: boolean,
  *   operation: shaka.net.NetworkingEngine.PendingRequest
@@ -2061,6 +2077,8 @@ shaka.media.StreamingEngine.PlayerInterface;
  *   The amount of buffer to retain when clearing the buffer after the update.
  * @property {boolean} clearingBuffer
  *   True indicates that the buffer is being cleared.
+  * @property {boolean} seeked
+ *   True indicates that the presentation just seeked.
  * @property {boolean} recovering
  *   True indicates that the last segment was not appended because it could not
  *   fit in the buffer.

package/lib/media/time_ranges_utils.js

@@ -54,17 +54,13 @@ shaka.media.TimeRangesUtils = class {
 
 
   /**
-   * Determines if the given time is inside a buffered range.  This includes
-   * gaps, meaning that if the playhead is in a gap, it is considered buffered.
-   * If there is a small gap between the playhead and buffer start, consider it
-   * as buffered.
+   * Determines if the given time is inside a buffered range.
    *
    * @param {TimeRanges} b
    * @param {number} time Playhead time
-   * @param {number=} smallGapLimit Set in configuration
    * @return {boolean}
    */
-  static isBuffered(b, time, smallGapLimit = 0) {
+  static isBuffered(b, time) {
     if (!b || !b.length) {
       return false;
     }
@@ -76,9 +72,8 @@ shaka.media.TimeRangesUtils = class {
     if (time > b.end(b.length - 1)) {
       return false;
     }
-    // Push the time forward by the gap limit so that it is more likely to be in
-    // the range.
-    return (time + smallGapLimit >= b.start(0));
+
+    return time >= b.start(0);
   }
 
 

package/lib/net/networking_engine.js

@@ -220,6 +220,9 @@ shaka.net.NetworkingEngine = class extends shaka.util.FakeEventTarget {
       retryParameters: retryParams,
       licenseRequestType: null,
       sessionId: null,
+      drmInfo: null,
+      initData: null,
+      initDataType: null,
       streamDataCallback: streamDataCallback,
     };
   }

package/lib/offline/indexeddb/v1_storage_cell.js

@@ -99,6 +99,7 @@ shaka.offline.indexeddb.V1StorageCell = class
       sessionIds: old.sessionIds,
       drmInfo: old.drmInfo,
       appMetadata: old.appMetadata,
+      sequenceMode: false,
     };
   }
 

package/lib/offline/indexeddb/v2_storage_cell.js

@@ -60,6 +60,7 @@ shaka.offline.indexeddb.V2StorageCell = class
       sessionIds: old.sessionIds,
       size: old.size,
       streams,
+      sequenceMode: false,
     };
   }
 

package/lib/offline/manifest_converter.js

@@ -87,6 +87,7 @@ shaka.offline.ManifestConverter = class {
       variants: Array.from(variants.values()),
       textStreams: textStreams,
       imageStreams: imageStreams,
+      sequenceMode: manifestDB.sequenceMode || false,
     };
   }