shaka-player 4.6.4 → 4.7.0

package/docs/design/dash-manifests.md

@@ -1,248 +0,0 @@
-# DASH Manifests
-
-This document describes some of the pieces of a DASH manifest and how they
-relate to playback.  This won't cover everything that DASH allows, but this will
-cover the important concepts and hopefully will alleviate some of the confusion
-many people have with DASH manifests.
-
-
-## Time
-
-When dealing with media and streaming, there are many different kinds of times
-we are dealing with.  Some don't apply to all cases; for example, VOD doesn't
-care about the wall-clock time.  It is important to use the correct words for
-the kind of time we are dealing with to avoid confusion.  It is possible to
-convert from one kind of time to another, but these all have distinct values
-that need to be considered different.
-
-### Presentation time
-
-The time within the presentation.  This represents the amount of time that has
-passed since the start of the presentation.  For VOD, this is the time since the
-beginning of the video; for live, this is the time since the live stream
-started.
-
-### Media time
-
-The time that is encoded within a media segment.  Each media segment has
-information in it for what time it should be played at.  The media time is not
-used by the player to determine presentation time; however, it is used by the
-media player (e.g. the browser) to play the segment.  So if the segment has a
-media time of 30 seconds, then the browser will put the segment at 30 seconds in
-the `<video>`.
-
-The manifest specifies values which can adjust the media time.  Both the
-`presentationTimeOffset` and the `Period@start` will change the media times so
-the segment appears at the correct time in the `<video>` element.
-
-### Wall-Clock time
-
-This represents the time as seen on a clock.  In terms of value, this is
-commonly represented as seconds since the epoch.  This does **not** mean the
-time that a segment will be played at.
-
-
-## Presentation Timeline
-
-The biggest concept in DASH is the presentation timeline.  This represents a
-unified timeline of what content to play.  This can be thought of as the time
-of a single VOD clip.  The timeline starts at 0 and describes at what time to
-play each segment.  So if a media segment has a presentation time of 30 seconds,
-then it will play 30 seconds after the presentation has started.
-
-Media times from different pieces of content are adjusted so they appear at the
-correct time within the timeline.  This allows concatenating different clips to
-form a continuous video playback.  Different streams may exist that describe
-different versions of the content to switch between (e.g. SD and HD).
-
-In Shaka Player, we only deal with presentation time.  We map this directly
-to the `<video>` element.  This means that `video.currentTime` represents the
-presentation time of the content.  So if you seek to 90 seconds, we will look
-up the segment that has a presentation time of 90 seconds.
-
-
-## Periods
-
-The presentation timeline is composed of one or more sequential Periods.  A
-Period represents an independent piece of the timeline.  Periods cannot overlap
-and should not have gaps between them (although Shaka Player supports gap
-jumping). Each Period has a start time, which can be explicit through the
-`start` attribute, or can be implicit by using the `duration` attribute of the
-previous Period.
-
-Content is clamped to a Period.  Any content that appears before the Period
-start or after the Period end will be dropped.  If the whole segment is outside
-the Period, the player will just ignore it.
-
-Note that we implement content deleting using the MSE `appendWindowStart`.  This
-has a subtle problem if we have a partial segment at the start of the Period.
-When the browser drops content at the start of the Period, it will continue to
-drop frames until the next keyframe.  This means that if your first segment
-starts at -0.1 relative to the Period (e.g. `PTO > S@t`), then we may loose the
-whole segment if there are no more keyframes in it.  See the
-[coded frame processing][] algorithm for more info.
-
-[coded frame processing]: https://w3c.github.io/media-source/#sourcebuffer-coded-frame-processing
-
-
-## Calculating presentation times
-
-```xml
-<Period start="PT30S" duration="PT10S">
-  <AdaptationSet>
-    <Representation>
-      <SegmentTemplate timescale="10" presentationTimeOffset="100"
-          media="s$Number$.mp4" initialization="init.mp4">
-        <SegmentTimeline>
-          <S t="111" d="40" />
-          <S d="10" />
-          <S t="170" d="10" />
-        </SegmentTimeline>
-      </SegmentTemplate>
-    </Representation>
-  </AdaptationSet>
-</Period>
-```
-
-The above example uses `SegmentTemplate` with `SegmentTimeline`, but you could
-easily use the other formats, there is no difference.  In any case, there is a
-list of the segments where each segment has a start and duration.
-
-Here is the general equation used to calculate presentation times.
-
-```js
-start = 111;  // S@t
-presentationTime = (start - presentationTimeOffset) / timescale + periodStart;
-```
-
-First the start time in the manifest needs to be offset by the
-`presentationTimeOffset` (PTO).  The reason this exists is because the time
-specified in the time attribute MUST match the media time.  The PTO will adjust
-the media time too; this means if you just change the `S@t`, when we append the
-media, the browser will put the segment at the wrong time since we didn't adjust
-the media time correctly.
-
-Next, both the start time and PTO are specified in timescale units, so we need
-to convert that to seconds.
-
-Lastly, times in the manifest are relative to the Period.  This means that you
-need to add the Period time to get the real presentation time.  This allows you
-to specify each Period independent to where the Period is within the timeline.
-This is especially useful for ad-insertion.
-
-So in the above example, the first segment starts playing at
-`(111 - 100) / 10 + 30`, or 31.1 seconds.  The first segment has a duration of
-`S@d / timescale` seconds so the second segment will start at 35.1 seconds.
-There is a gap before the third segment, and it will start at
-`(170 - 100) / 10 + 30` or 37 seconds.
-
-![timeline example](dash-timeline.svg)
-
-### Choosing values for presentationTimeOffset (PTO)
-
-You want to set `S@t` to exactly the same value as the media time.  If that
-doesn't result in a presentation time you want, you should use PTO or Period
-start to change that.  If there is a single Period, you can have Period start be
-0 and just use PTO to adjust the segment to be at the right time; in
-multi-Period content you'll need to adjust it so that the segments within the
-Period start at 0.
-
-Be sure to use the same value for PTO for all streams.  It may be tempting to
-just use the first `S@t` value for PTO, but that won't work.  If you use
-different values, it will result in audio/video de-sync since they have been
-adjusted by different amounts.  It is better to pick a specific value and set
-each stream to the same value (make sure to account for timescale).
-
-Also when choosing between two values for PTO, it is suggested to use the
-smaller value.  If you use the bigger one, then the Period-relative time of the
-other stream will be negative.  See note in the Periods section above.
-
-
-## Live
-
-It is important to note that live works almost exactly the same as VOD.  Live
-still has the same timeline and same presentation times.  For live content,
-the presentation time of 0 represents when the live stream started.  This is
-given in the manifest as `availabilityStartTime`.  So when we start playing a
-live stream, we will calculate the difference between `now` and the start time
-and that gives us the current presentation time to play at.
-
-Important: You shouldn't map presentation times to wall-clock times.  If a
-media segment has a presentation time of 5 minutes and an AST of 9:00, that
-doesn't mean the segment will be played at 9:05; the app can pause the video
-which will delay when it is played.  All it means is that is when it was
-recorded.
-
-Also note that it is common to use Unix timestamps for the media timestamps in
-live content.  Then setting the AST to the epoch means the segments appear at
-the correct time.  This is valid, but not required.  Just like VOD content, the
-media time doesn't matter so long as the adjusted presentation time puts the
-segment at the correct position.
-
-### Live edge
-
-When playing live content, we need to determine what the current time is.  The
-live edge is the latest edge of the live playback, in presentation time.  As we
-are playing, the live edge moves forward with the current wall-clock time.
-
-To calculate the live edge, we look at the `availabilityStartTime` (AST) to
-determine the wall-clock time that the stream started.  The current wall-clock
-time is equivalent to `now - AST` in presentation time; however, the server is
-still recording that segment, so we can't play it yet.  So we back the live edge
-up by the segment size.  So the live edge is `now - AST - maxSegmentSize`.
-
-```js
-const ast = 1518717600;  // availabilityStartTime="2018-02-15T18:00:00Z"
-const now = 1518718680;  // (Date.now() / 1000) -> 2018-02-15T18:18:00Z
-const maxSegmentSize = 10;  // seconds
-
-const liveEdge = now - ast - maxSegmentSize;  // 1070
-
-video.currentTime = liveEdge;  // Start playing at live edge.
-// We'll start playing segments with a *presentation time* around 1070.
-```
-
-But even then, manifest updates and network delays can cause us to stall if we
-try to play at the live edge.  So we will actually delay where we will play at
-so we don't stall.  The time we adjust by can be specified in the manifest using
-the `MPD@suggestedPresentationDelay` attribute.  This specifies the delay to
-give the live stream to allow for smooth playback.  If it isn't specified, we
-will give a reasonable default value.
-
-### Segment availability
-
-DASH has a concept of availability.  This defines which segments can be
-downloaded from the server.  So long as a segment is available, the segment MUST
-exist on the server to be downloaded.  The availability of a segment is
-determined by the `MPD@timeShiftBufferDepth` attribute.  This specifies a
-moving window of availability around the live edge.  So if the TSBD attribute
-is 10 minutes, that means that you can play the most recent 10 minutes of a
-live stream; or specifically, the seekable range of presentation times is
-between the live edge and 10 minutes before that.
-
-A manifest may list more or fewer segments than the availability window.  If it
-lists more, the extra segments may already be unavailable when the manifest is
-downloaded; if the manifest lists less segments, then we may not be able to fill
-the whole availability window.  Note that the player is allowed to remember the
-segments even if they are no longer listed.  So if an updated manifest no longer
-includes some segments, they are still available to be downloaded until they
-fall outside the availability window.
-
-### Clock sync
-
-Since both the live edge and the availability window calculations involve the
-current wall-clock time, both the server and the client need to have
-synchronized clocks.  This is done in DASH by using the `UTCTiming` element;
-this specifies how to get an accurate clock time on the server so the client can
-alter the client clock to match.
-
-This means that DASH manifests are sensitive to drift and clock-sync issues.  It
-is very common for live manifests to have clock problems, so if your live
-manifest doesn't play, it is likely because of clock sync.  This is so common
-that Shaka Player will be changing to determine the live edge using the list of
-segments.  You can follow progress in [#999][].  But note that DASH requires
-accurate clock times, so even after that feature is added, your manifest may
-not play in other DASH players.
-
-[#999]: https://github.com/shaka-project/shaka-player/issues/999
-

package/docs/design/dash-timeline.svg

@@ -1,4 +0,0 @@
-<?xml version="1.0" standalone="yes"?>
-
-<svg version="1.1" viewBox="0.0 0.0 948.1102362204724 282.00787401574803" fill="none" stroke="none" stroke-linecap="square" stroke-miterlimit="10" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><clipPath id="p.0"><path d="m0 0l948.1102 0l0 282.00787l-948.1102 0l0 -282.00787z" clip-rule="nonzero"></path></clipPath><g clip-path="url(#p.0)"><path fill="#000000" fill-opacity="0.0" d="m0 0l948.1102 0l0 282.00787l-948.1102 0z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m223.44356 73.603676l521.6693 0l0 85.826775l-521.6693 0z" fill-rule="evenodd"></path><path stroke="#000000" stroke-width="1.0" stroke-linejoin="round" stroke-linecap="butt" d="m223.44356 73.603676l521.6693 0l0 85.826775l-521.6693 0z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m234.50919 120.72179l42.236206 0l0 38.708664l-42.236206 0z" fill-rule="evenodd"></path><path fill="#000000" d="m247.97794 141.24179l-1.046875 0l0 -6.71875q-0.390625 0.359375 -1.015625 0.734375q-0.609375 0.359375 -1.09375 0.53125l0 -1.015625q0.875 -0.421875 1.53125 -1.0q0.671875 -0.59375 0.953125 -1.15625l0.671875 0l0 8.625zm3.2988281 0l0 -1.203125l1.203125 0l0 1.203125l-1.203125 0zm6.7089844 0l-1.046875 0l0 -6.71875q-0.390625 0.359375 -1.015625 0.734375q-0.609375 0.359375 -1.09375 0.53125l0 -1.015625q0.875 -0.421875 1.53125 -1.0q0.671875 -0.59375 0.953125 -1.15625l0.671875 0l0 8.625z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m80.125984 165.88452l799.74805 0" fill-rule="evenodd"></path><path stroke="#000000" stroke-width="1.0" stroke-linejoin="round" stroke-linecap="butt" d="m80.125984 165.88452l799.74805 0" fill-rule="evenodd"></path><path fill="#cfe2f3" d="m89.05502 73.603676l112.59842 0l0 85.826775l-112.59842 0z" fill-rule="evenodd"></path><path stroke="#000000" stroke-width="1.0" stroke-linejoin="round" stroke-linecap="butt" d="m89.05502 73.603676l112.59842 0l0 85.826775l-112.59842 0z" fill-rule="evenodd"></path><path fill="#cfe2f3" d="m759.7664 73.603676l112.59839 0l0 85.826775l-112.59839 0z" fill-rule="evenodd"></path><path stroke="#000000" stroke-width="1.0" stroke-linejoin="round" stroke-linecap="butt" d="m759.7664 73.603676l112.59839 0l0 85.826775l-112.59839 0z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m89.055115 73.603676l112.598434 0l0 85.826775l-112.598434 0z" fill-rule="evenodd"></path><path fill="#000000" d="m112.04821 123.43706l0 -13.359375l5.046875 0q1.328125 0 2.03125 0.125q0.96875 0.171875 1.640625 0.640625q0.671875 0.453125 1.078125 1.28125q0.40625 0.828125 0.40625 1.828125q0 1.703125 -1.09375 2.890625q-1.078125 1.171875 -3.921875 1.171875l-3.421875 0l0 5.421875l-1.765625 0zm1.765625 -7.0l3.453125 0q1.71875 0 2.4375 -0.640625q0.71875 -0.640625 0.71875 -1.796875q0 -0.84375 -0.421875 -1.4375q-0.421875 -0.59375 -1.125 -0.78125q-0.4375 -0.125 -1.640625 -0.125l-3.421875 0l0 4.78125zm17.099815 3.890625l1.6875 0.203125q-0.40625 1.484375 -1.484375 2.3125q-1.078125 0.8125 -2.765625 0.8125q-2.1249924 0 -3.3749924 -1.296875q-1.234375 -1.3125 -1.234375 -3.671875q0 -2.453125 1.25 -3.796875q1.265625 -1.34375 3.2656174 -1.34375q1.9375 0 3.15625 1.328125q1.234375 1.3125 1.234375 3.703125q0 0.15625 0 0.4375l-7.2187424 0q0.09375 1.59375 0.90625 2.453125q0.8125 0.84375 2.0156174 0.84375q0.90625 0 1.546875 -0.46875q0.640625 -0.484375 1.015625 -1.515625zm-5.3906174 -2.65625l5.4062424 0q-0.109375 -1.21875 -0.625 -1.828125q-0.78125 -0.953125 -2.03125 -0.953125q-1.1249924 0 -1.9062424 0.765625q-0.765625 0.75 -0.84375 2.015625zm9.12571 5.765625l0 -9.671875l1.46875 0l0 1.46875q0.5625 -1.03125 1.03125 -1.359375q0.484375 -0.328125 1.0625 -0.328125q0.828125 0 1.6875 0.53125l-0.5625 1.515625q-0.609375 -0.359375 -1.203125 -0.359375q-0.546875 0 -0.96875 0.328125q-0.421875 0.328125 -0.609375 0.890625q-0.28125 0.875 -0.28125 1.921875l0 5.0625l-1.625 0zm6.228302 -11.46875l0 -1.890625l1.640625 0l0 1.890625l-1.640625 0zm0 11.46875l0 -9.671875l1.640625 0l0 9.671875l-1.640625 0zm3.5354462 -4.84375q0 -2.6875 1.484375 -3.96875q1.25 -1.078125 3.046875 -1.078125q2.0 0 3.265625 1.3125q1.265625 1.296875 1.265625 3.609375q0 1.859375 -0.5625 2.9375q-0.5625 1.0625 -1.640625 1.65625q-1.0625 0.59375 -2.328125 0.59375q-2.03125 0 -3.28125 -1.296875q-1.25 -1.3125 -1.25 -3.765625zm1.6875 0q0 1.859375 0.796875 2.796875q0.8125 0.921875 2.046875 0.921875q1.21875 0 2.03125 -0.921875q0.8125 -0.9375 0.8125 -2.84375q0 -1.796875 -0.8125 -2.71875q-0.8125 -0.921875 -2.03125 -0.921875q-1.234375 0 -2.046875 0.921875q-0.796875 0.90625 -0.796875 2.765625zm15.563217 4.84375l0 -1.21875q-0.90625 1.4375 -2.703125 1.4375q-1.15625 0 -2.125 -0.640625q-0.96875 -0.640625 -1.5 -1.78125q-0.53125 -1.140625 -0.53125 -2.625q0 -1.453125 0.484375 -2.625q0.484375 -1.1875 1.4375 -1.8125q0.96875 -0.625 2.171875 -0.625q0.875 0 1.546875 0.375q0.6875 0.359375 1.109375 0.953125l0 -4.796875l1.640625 0l0 13.359375l-1.53125 0zm-5.171875 -4.828125q0 1.859375 0.78125 2.78125q0.78125 0.921875 1.84375 0.921875q1.078125 0 1.828125 -0.875q0.75 -0.890625 0.75 -2.6875q0 -1.984375 -0.765625 -2.90625q-0.765625 -0.9375 -1.890625 -0.9375q-1.078125 0 -1.8125 0.890625q-0.734375 0.890625 -0.734375 2.8125zm14.012146 -1.765625q0 -2.359375 0.484375 -3.796875q0.484375 -1.453125 1.4375 -2.234375q0.96875 -0.78125 2.421875 -0.78125q1.078125 0 1.890625 0.4375q0.8125 0.421875 1.328125 1.25q0.53125 0.8125 0.828125 1.984375q0.3125 1.15625 0.3125 3.140625q0 2.359375 -0.484375 3.8125q-0.484375 1.4375 -1.453125 2.234375q-0.953125 0.78125 -2.421875 0.78125q-1.921875 0 -3.03125 -1.390625q-1.3125 -1.671875 -1.3125 -5.4375zm1.671875 0q0 3.296875 0.765625 4.390625q0.78125 1.078125 1.90625 1.078125q1.140625 0 1.90625 -1.09375q0.765625 -1.09375 0.765625 -4.375q0 -3.296875 -0.765625 -4.375q-0.765625 -1.078125 -1.921875 -1.078125q-1.125 0 -1.796875 0.953125q-0.859375 1.21875 -0.859375 4.5z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m759.7664 73.603676l112.59839 0l0 85.826775l-112.59839 0z" fill-rule="evenodd"></path><path fill="#000000" d="m782.7595 123.43706l0 -13.359375l5.046875 0q1.328125 0 2.03125 0.125q0.96875 0.171875 1.640625 0.640625q0.671875 0.453125 1.078125 1.28125q0.40625 0.828125 0.40625 1.828125q0 1.703125 -1.09375 2.890625q-1.078125 1.171875 -3.921875 1.171875l-3.421875 0l0 5.421875l-1.765625 0zm1.765625 -7.0l3.453125 0q1.71875 0 2.4375 -0.640625q0.71875 -0.640625 0.71875 -1.796875q0 -0.84375 -0.421875 -1.4375q-0.421875 -0.59375 -1.125 -0.78125q-0.4375 -0.125 -1.640625 -0.125l-3.421875 0l0 4.78125zm17.099792 3.890625l1.6875 0.203125q-0.40625 1.484375 -1.484375 2.3125q-1.078125 0.8125 -2.765625 0.8125q-2.125 0 -3.375 -1.296875q-1.234375 -1.3125 -1.234375 -3.671875q0 -2.453125 1.25 -3.796875q1.265625 -1.34375 3.265625 -1.34375q1.9375 0 3.15625 1.328125q1.234375 1.3125 1.234375 3.703125q0 0.15625 0 0.4375l-7.21875 0q0.09375 1.59375 0.90625 2.453125q0.8125 0.84375 2.015625 0.84375q0.90625 0 1.546875 -0.46875q0.640625 -0.484375 1.015625 -1.515625zm-5.390625 -2.65625l5.40625 0q-0.109375 -1.21875 -0.625 -1.828125q-0.78125 -0.953125 -2.03125 -0.953125q-1.125 0 -1.90625 0.765625q-0.765625 0.75 -0.84375 2.015625zm9.125732 5.765625l0 -9.671875l1.46875 0l0 1.46875q0.5625 -1.03125 1.03125 -1.359375q0.484375 -0.328125 1.0625 -0.328125q0.828125 0 1.6875 0.53125l-0.5625 1.515625q-0.609375 -0.359375 -1.203125 -0.359375q-0.546875 0 -0.96875 0.328125q-0.421875 0.328125 -0.609375 0.890625q-0.28125 0.875 -0.28125 1.921875l0 5.0625l-1.625 0zm6.2282715 -11.46875l0 -1.890625l1.640625 0l0 1.890625l-1.640625 0zm0 11.46875l0 -9.671875l1.640625 0l0 9.671875l-1.640625 0zm3.5354614 -4.84375q0 -2.6875 1.484375 -3.96875q1.25 -1.078125 3.046875 -1.078125q2.0 0 3.265625 1.3125q1.265625 1.296875 1.265625 3.609375q0 1.859375 -0.5625 2.9375q-0.5625 1.0625 -1.640625 1.65625q-1.0625 0.59375 -2.328125 0.59375q-2.03125 0 -3.28125 -1.296875q-1.25 -1.3125 -1.25 -3.765625zm1.6875 0q0 1.859375 0.796875 2.796875q0.8125 0.921875 2.046875 0.921875q1.21875 0 2.03125 -0.921875q0.8125 -0.9375 0.8125 -2.84375q0 -1.796875 -0.8125 -2.71875q-0.8125 -0.921875 -2.03125 -0.921875q-1.234375 0 -2.046875 0.921875q-0.796875 0.90625 -0.796875 2.765625zm15.563232 4.84375l0 -1.21875q-0.90625 1.4375 -2.703125 1.4375q-1.15625 0 -2.125 -0.640625q-0.96875 -0.640625 -1.5 -1.78125q-0.53125 -1.140625 -0.53125 -2.625q0 -1.453125 0.484375 -2.625q0.484375 -1.1875 1.4375 -1.8125q0.96875 -0.625 2.171875 -0.625q0.875 0 1.546875 0.375q0.6875 0.359375 1.109375 0.953125l0 -4.796875l1.640625 0l0 13.359375l-1.53125 0zm-5.171875 -4.828125q0 1.859375 0.78125 2.78125q0.78125 0.921875 1.84375 0.921875q1.078125 0 1.828125 -0.875q0.75 -0.890625 0.75 -2.6875q0 -1.984375 -0.765625 -2.90625q-0.765625 -0.9375 -1.890625 -0.9375q-1.078125 0 -1.8125 0.890625q-0.734375 0.890625 -0.734375 2.8125zm22.621521 3.25l0 1.578125l-8.828125 0q-0.015625 -0.59375 0.1875 -1.140625q0.34375 -0.90625 1.078125 -1.78125q0.75 -0.875 2.15625 -2.015625q2.171875 -1.78125 2.9375 -2.828125q0.765625 -1.046875 0.765625 -1.96875q0 -0.984375 -0.703125 -1.640625q-0.6875 -0.671875 -1.8125 -0.671875q-1.1875 0 -1.90625 0.71875q-0.703125 0.703125 -0.703125 1.953125l-1.6875 -0.171875q0.171875 -1.890625 1.296875 -2.875q1.140625 -0.984375 3.03125 -0.984375q1.921875 0 3.046875 1.0625q1.125 1.0625 1.125 2.640625q0 0.796875 -0.328125 1.578125q-0.328125 0.78125 -1.09375 1.640625q-0.75 0.84375 -2.53125 2.34375q-1.46875 1.234375 -1.890625 1.6875q-0.421875 0.4375 -0.6875 0.875l6.546875 0z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m201.65355 165.88452l57.448807 0l0 42.519684l-57.448807 0z" fill-rule="evenodd"></path><path fill="#000000" d="m211.4348 189.27327l1.640625 -0.21875q0.28125 1.40625 0.953125 2.015625q0.6875 0.609375 1.65625 0.609375q1.15625 0 1.953125 -0.796875q0.796875 -0.796875 0.796875 -1.984375q0 -1.125 -0.734375 -1.859375q-0.734375 -0.734375 -1.875 -0.734375q-0.46875 0 -1.15625 0.171875l0.1875 -1.4375q0.15625 0.015625 0.265625 0.015625q1.046875 0 1.875 -0.546875q0.84375 -0.546875 0.84375 -1.671875q0 -0.90625 -0.609375 -1.5q-0.609375 -0.59375 -1.578125 -0.59375q-0.953125 0 -1.59375 0.609375q-0.640625 0.59375 -0.8125 1.796875l-1.640625 -0.296875q0.296875 -1.640625 1.359375 -2.546875q1.0625 -0.90625 2.65625 -0.90625q1.09375 0 2.0 0.46875q0.921875 0.46875 1.40625 1.28125q0.5 0.8125 0.5 1.71875q0 0.859375 -0.46875 1.578125q-0.46875 0.703125 -1.375 1.125q1.1875 0.28125 1.84375 1.140625q0.65625 0.859375 0.65625 2.15625q0 1.734375 -1.28125 2.953125q-1.265625 1.21875 -3.21875 1.21875q-1.765625 0 -2.921875 -1.046875q-1.15625 -1.046875 -1.328125 -2.71875zm10.375717 -3.0625q0 -2.359375 0.484375 -3.796875q0.484375 -1.453125 1.4375 -2.234375q0.96875 -0.78125 2.421875 -0.78125q1.078125 0 1.890625 0.4375q0.8125 0.421875 1.328125 1.25q0.53125 0.8125 0.828125 1.984375q0.3125 1.15625 0.3125 3.140625q0 2.359375 -0.484375 3.8125q-0.484375 1.4375 -1.453125 2.234375q-0.953125 0.78125 -2.421875 0.78125q-1.921875 0 -3.03125 -1.390625q-1.3125 -1.671875 -1.3125 -5.4375zm1.671875 0q0 3.296875 0.765625 4.390625q0.78125 1.078125 1.90625 1.078125q1.140625 0 1.90625 -1.09375q0.765625 -1.09375 0.765625 -4.375q0 -3.296875 -0.765625 -4.375q-0.765625 -1.078125 -1.921875 -1.078125q-1.125 0 -1.796875 0.953125q-0.859375 1.21875 -0.859375 4.5z" fill-rule="nonzero"></path><path fill="#cfe2f3" d="m288.55643 100.850395l191.43307 0l0 31.590553l-191.43307 0z" fill-rule="evenodd"></path><path stroke="#000000" stroke-width="1.0" stroke-linejoin="round" stroke-linecap="butt" d="m288.55643 100.850395l191.43307 0l0 31.590553l-191.43307 0z" fill-rule="evenodd"></path><path fill="#cfe2f3" d="m480.0 100.850395l63.84253 0l0 31.590553l-63.84253 0z" fill-rule="evenodd"></path><path stroke="#000000" stroke-width="1.0" stroke-linejoin="round" stroke-linecap="butt" d="m480.0 100.850395l63.84253 0l0 31.590553l-63.84253 0z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m724.9449 165.88452l57.44879 0l0 42.519684l-57.44879 0z" fill-rule="evenodd"></path><path fill="#000000" d="m739.97614 192.80452l0 -3.203125l-5.796875 0l0 -1.5l6.09375 -8.65625l1.34375 0l0 8.65625l1.796875 0l0 1.5l-1.796875 0l0 3.203125l-1.640625 0zm0 -4.703125l0 -6.015625l-4.1875 6.015625l4.1875 0zm5.1257324 -1.890625q0 -2.359375 0.484375 -3.796875q0.484375 -1.453125 1.4375 -2.234375q0.96875 -0.78125 2.421875 -0.78125q1.078125 0 1.890625 0.4375q0.8125 0.421875 1.328125 1.25q0.53125 0.8125 0.828125 1.984375q0.3125 1.15625 0.3125 3.140625q0 2.359375 -0.484375 3.8125q-0.484375 1.4375 -1.453125 2.234375q-0.953125 0.78125 -2.421875 0.78125q-1.921875 0 -3.03125 -1.390625q-1.3125 -1.671875 -1.3125 -5.4375zm1.671875 0q0 3.296875 0.765625 4.390625q0.78125 1.078125 1.90625 1.078125q1.140625 0 1.90625 -1.09375q0.765625 -1.09375 0.765625 -4.375q0 -3.296875 -0.765625 -4.375q-0.765625 -1.078125 -1.921875 -1.078125q-1.125 0 -1.796875 0.953125q-0.859375 1.21875 -0.859375 4.5z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m223.70604 147.29396l63.842514 0" fill-rule="evenodd"></path><path stroke="#000000" stroke-width="1.0" stroke-linejoin="round" stroke-linecap="butt" d="m229.70604 147.29396l51.842514 0" fill-rule="evenodd"></path><path fill="#000000" stroke="#000000" stroke-width="1.0" stroke-linecap="butt" d="m229.70604 145.64223l-4.538101 1.6517334l4.538101 1.6517334z" fill-rule="evenodd"></path><path fill="#000000" stroke="#000000" stroke-width="1.0" stroke-linecap="butt" d="m281.54855 148.9457l4.538086 -1.6517334l-4.538086 -1.6517334z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m288.55643 154.83464l190.04724 0" fill-rule="evenodd"></path><path stroke="#000000" stroke-width="1.0" stroke-linejoin="round" stroke-linecap="butt" d="m294.55643 154.83464l178.04724 0" fill-rule="evenodd"></path><path fill="#000000" stroke="#000000" stroke-width="1.0" stroke-linecap="butt" d="m294.55643 153.1829l-4.538086 1.6517334l4.538086 1.6517334z" fill-rule="evenodd"></path><path fill="#000000" stroke="#000000" stroke-width="1.0" stroke-linecap="butt" d="m472.60367 156.48637l4.5381165 -1.6517334l-4.5381165 -1.6517334z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m367.67978 130.26509l32.188995 0l0 29.16536l-32.188995 0z" fill-rule="evenodd"></path><path fill="#000000" d="m380.55478 150.7851l0 -2.0625l-3.71875 0l0 -0.96875l3.921875 -5.5625l0.859375 0l0 5.5625l1.15625 0l0 0.96875l-1.15625 0l0 2.0625l-1.0625 0zm0 -3.03125l0 -3.859375l-2.6875 3.859375l2.6875 0z" fill-rule="nonzero"></path><path fill="#000000" fill-opacity="0.0" d="m457.0866 165.88452l45.826782 0l0 42.519684l-45.826782 0z" fill-rule="evenodd"></path><path fill="#000000" d="m466.86786 189.27327l1.640625 -0.21875q0.28125 1.40625 0.953125 2.015625q0.6875 0.609375 1.65625 0.609375q1.15625 0 1.953125 -0.796875q0.796875 -0.796875 0.796875 -1.984375q0 -1.125 -0.734375 -1.859375q-0.734375 -0.734375 -1.875 -0.734375q-0.46875 0 -1.15625 0.171875l0.1875 -1.4375q0.15625 0.015625 0.265625 0.015625q1.046875 0 1.875 -0.546875q0.84375 -0.546875 0.84375 -1.671875q0 -0.90625 -0.609375 -1.5q-0.609375 -0.59375 -1.578125 -0.59375q-0.953125 0 -1.59375 0.609375q-0.640625 0.59375 -0.8125 1.796875l-1.640625 -0.296875q0.296875 -1.640625 1.359375 -2.546875q1.0625 -0.90625 2.65625 -0.90625q1.09375 0 2.0 0.46875q0.921875 0.46875 1.40625 1.28125q0.5 0.8125 0.5 1.71875q0 0.859375 -0.46875 1.578125q-0.46875 0.703125 -1.375 1.125q1.1875 0.28125 1.84375 1.140625q0.65625 0.859375 0.65625 2.15625q0 1.734375 -1.28125 2.953125q-1.265625 1.21875 -3.21875 1.21875q-1.765625 0 -2.921875 -1.046875q-1.15625 -1.046875 -1.328125 -2.71875zm10.375732 0.03125l1.71875 -0.140625q0.1875 1.25 0.875 1.890625q0.703125 0.625 1.6875 0.625q1.1875 0 2.0 -0.890625q0.828125 -0.890625 0.828125 -2.359375q0 -1.40625 -0.796875 -2.21875q-0.78125 -0.8125 -2.0625 -0.8125q-0.78125 0 -1.421875 0.359375q-0.640625 0.359375 -1.0 0.9375l-1.546875 -0.203125l1.296875 -6.859375l6.640625 0l0 1.5625l-5.328125 0l-0.71875 3.59375q1.203125 -0.84375 2.515625 -0.84375q1.75 0 2.953125 1.21875q1.203125 1.203125 1.203125 3.109375q0 1.8125 -1.046875 3.140625q-1.296875 1.625 -3.515625 1.625q-1.8125 0 -2.96875 -1.015625q-1.15625 -1.03125 -1.3125 -2.71875z" fill-rule="nonzero"></path><path fill="#cfe2f3" d="m575.0131 100.850395l63.84253 0l0 31.590553l-63.84253 0z" fill-rule="evenodd"></path><path stroke="#000000" stroke-width="1.0" stroke-linejoin="round" stroke-linecap="butt" d="m575.0131 100.850395l63.84253 0l0 31.590553l-63.84253 0z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m223.70604 80.43307l351.40155 0" fill-rule="evenodd"></path><path stroke="#000000" stroke-width="1.0" stroke-linejoin="round" stroke-linecap="butt" d="m229.70604 80.43307l339.40155 0" fill-rule="evenodd"></path><path fill="#000000" stroke="#000000" stroke-width="1.0" stroke-linecap="butt" d="m229.70604 78.78134l-4.538101 1.6517258l4.538101 1.6517334z" fill-rule="evenodd"></path><path fill="#000000" stroke="#000000" stroke-width="1.0" stroke-linecap="butt" d="m569.1076 82.0848l4.538086 -1.6517334l-4.538086 -1.6517258z" fill-rule="evenodd"></path><path fill="#000000" fill-opacity="0.0" d="m405.60104 71.580055l25.13385 0l0 33.795273l-25.13385 0z" fill-rule="evenodd"></path><path fill="#000000" d="m415.16354 84.6313l0 -1.015625l5.5625 0l0 0.828125q-0.8125 0.875 -1.625 2.328125q-0.796875 1.4375 -1.234375 2.96875q-0.328125 1.078125 -0.40625 2.359375l-1.09375 0q0.015625 -1.015625 0.390625 -2.453125q0.390625 -1.4375 1.09375 -2.765625q0.71875 -1.328125 1.53125 -2.25l-4.21875 0z" fill-rule="nonzero"></path></g></svg>
-

package/docs/design/dataflow.gv

@@ -1,66 +0,0 @@
-# Generate png with: dot -Tpng -O dataflow.gv
-
-digraph shaka2_data {
-  label=<<u>Shaka 2 Data Flow Diagram (excluding Cast, Offline)</u>>
-  labelloc=t
-  node [ shape=rectangle ]
-  edge [ fontsize=10 ]
-
-  SourceBuffer [ shape=oval ]
-  TextTrack [ shape=oval ]
-
-  AbrManager [ shape=trapezium ]
-  ManifestParser [ shape=trapezium ]
-  TextDisplayer [ shape=trapezium ]
-  TextParser [ shape=trapezium ]
-  RequestFilter [ shape=trapezium ]
-  ResponseFilter [ shape=trapezium ]
-  HttpFetchPlugin [ shape=trapezium ]
-
-  Player -> AbrManager [ label="Variants => Variant" dir=both arrowtail=onormal style=dashed ]
-  Player -> ManifestParser [ label="URL => Manifest" dir=both arrowtail=onormal style=dashed ]
-  Player -> StreamingEngine [ label=Manifest ]
-  Player -> DrmEngine [ label=Manifest ]
-
-  ManifestParser -> NetworkingEngine [ label="Request(MANIFEST) => Response" dir=both arrowtail=onormal style=dashed ]
-  StreamingEngine -> NetworkingEngine [ label="Request(SEGMENT) => Response" dir=both arrowtail=onormal style=dashed ]
-  DrmEngine -> NetworkingEngine [ label="Request(LICENSE) => Response" dir=both arrowtail=onormal style=dashed ]
-
-  StreamingEngine -> MediaSourceEngine [ label="ArrayBuffer" ]
-  MediaSourceEngine -> SourceBuffer [ label="ArrayBuffer" ]
-  MediaSourceEngine -> TextEngine [ label="ArrayBuffer" ]
-  MediaSourceEngine -> Transmuxer [ label="ArrayBuffer => ArrayBuffer" dir=both arrowtail=onormal style=dashed ]
-
-  TextEngine -> TextParser [ label="ArrayBuffer => Cues" dir=both arrowtail=onormal ]
-  TextEngine -> TextDisplayer [ label="Cues" ]
-  TextDisplayer -> TextTrack [ label="TextCues" ]
-
-  NetworkingEngine -> RequestFilter [ label="Request => Request" dir=both arrowtail=onormal style=dashed ]
-  NetworkingEngine -> ResponseFilter [ label="Response => Response" dir=both arrowtail=onormal style=dashed ]
-  NetworkingEngine -> HttpFetchPlugin [ label="Request => Response" dir=both arrowtail=onormal style=dashed ]
-
-  subgraph cluster_legend {
-    style=rounded
-    color="#444444"
-    label=<<u>Legend</u>>
-    fontsize=12
-    fontcolor="#444444"
-
-    node [ shape=plaintext color="#444444" fontsize=10 fontcolor="#444444" ]
-    edge [ color="#444444" fontcolor="#444444" ]
-
-    blank1 [ label="" fixedsize=true height=0 ]
-    blank2 [ label="" fixedsize=true height=0 ]
-    blank3 [ label="" fixedsize=true height=0 ]
-    "async request" -> blank3 [ dir=both arrowtail=onormal style=dashed ]
-    "request with return value" -> blank2 [ dir=both arrowtail=onormal label="ArgType => ReturnType" ]
-    "data pushed one way" -> blank1 [ label="DataType" ]
-
-    plugin [ shape=trapezium ]
-    "browser built-in" [ shape=oval ]
-    "internal class" [ shape=rectangle ]
-  }
-
-  # Hack to move the legend beneath the main graph:
-  TextParser -> "internal class" [ style=invisible arrowhead=none ]
-}

package/docs/design/export.md

@@ -1,70 +0,0 @@
-# Shaka Player Exports
-
-## True exports
-
-Shaka Player uses the Closure Compiler to compile the raw sources into a single
-bundle.  In this compiled bundle, most symbols have been renamed to short,
-internal-only names.
-
-Symbols that the application needs to access must be exported.  Exporting is the
-process of attaching these internal, renamed symbols to the exported namespace.
-(An example of an exported namespace is `window`.  If you are using a module
-loader like requirejs, the exported namespace is returned to from the loader.)
-
-The compiler has a special annotation for this: `@export`.  Anything annotated
-with `@export` will be exported by the compiler automatically.
-
-
-## Exporting to the docs
-
-We generate our documentation from the same annotations that we feed to the
-compiler.  To make it clear in the generated docs what is exported, public, or
-private, we added support for the `@export` annotation in jsdoc.
-
-There are situations where we want something to show up in the exports section
-of the docs, even though it can't be truly exported by the compiler.  For
-example, event definitions are part of the interface to our library, so they
-should show up in the exports section of the docs.  As far as the compiler is
-concerned, though, these are just typedefs that don't actually exist in the
-runtime environment.
-
-For this scenario, we created a new annotation: `@exportDoc`.  This is ignored
-by the compiler, but is consumed by our customized copy of jsdoc.
-
-
-## Generating externs
-
-The compiler has a concept of something called externs.  Externs are definitions
-of things that come from the external runtime environment.  For example, the
-compiler has built-in externs for most standard web APIs provided by the
-browser.
-
-If you are building something with the Closure Compiler and you want to import
-another library, you must have externs for that library so that the compiler can
-know what the APIs and types are for that library.
-
-We have a build step that generates externs for Shaka Player itself.  This is
-useful for importing Shaka Player into another Closure-based project.
-
-There are some abstract interfaces and internal base classes in Shaka Player
-that need to be in the generated externs, but should not be exported by the
-compiler because they are not part of the library's public API.  For example,
-`shaka.util.IDestroyable`, which is implemented by `shaka.Player`.
-
-To make this work, we created another new annotation: `@exportInterface`.  This
-annotation is used by the extern generator, but is ignored by the compiler.
-
-In some cases, public member variables need to be preserved when they would
-otherwise be renamed by the compiler. `@export` is not sufficient to keep the
-names from being renamed and is only useful for static members or prototype
-values. `@expose` used to be used for this but is now deprecated. The current
-best practice is to write an externs file defining the properties that should
-be preserved.
-
-
-## Summary
-
- - `@export`: truly exported (attached to namespace) by the compiler
- - `@expose`: deprecated
- - `@exportDoc`: considered part of the exports in the docs
- - `@exportInterface`: considered part of the exports in generated externs

package/docs/design/fuzzy-locale-matching.md

@@ -1,40 +0,0 @@
-# Shaka Player - Fuzzy Locale Matching
-
-## Summary
-Language is a complex issue, and trying to match what language someone speaks with the best content option leaves a lot of room for interpretation. The core lesson we have learned from this is that if you try to be strict, you will be wrong most of the time. Because of this, when comparing the languages that a user wants with the content we have, we have adopted this strategy.
-
-## Background
-For a full explanation of the terms and definitions used when we talk about language please see our ["Talking about Languages"](talking-about-languages.md) article.
-
-## Strategy
-The question boils down to, "If the user says they prefer a specific locale, and we don't have it. What locale should we present to them?" To make things easier on us, we do not support dialects in our searches. When we read the locale, we purposely drop the dialect component as it simplifies the searches. We chose to adopt this short-cut because we have yet to see dialects appear in any content.
-
-Conceptually locales follow a tree-like structure, so give a set of locales, we could create a tree like:
-
-![Locales Tree](locales_tree.svg)
-
-When we look for the best match, we try three searches. The searches are ordered from best to worst match so that once a match is found, we can stop searching. The searches are:
- - Locale Compatible
- - Parent Locale - A check where we see if one of our locales is the "parent" of the user's locale. For this to work:
-   - our locale must only have a language component
-   - the user's locale must have a language and region component
-   - both locales must be Language Compatible
- - Language Compatible
-
-## Examples
-If we assume that we can only respond to requests with the following locales:
- - en
- - en-CA
- - en-US
- - fr-CA
-
-Then for any given request, we should be able to identify what match we can make and what locale we would respond wit. The table below shows some examples:
-
-```
-User Wants | Matching Type       | Locale
------------|---------------------|----------
-en         | Locale Compatible   | en
-en-UK      | Parent Locale       | en
-fr         | Language Compatible | fr-CA
-zk         | No Match            | No Match
-```

package/docs/design/gap-jumping.md

@@ -1,151 +0,0 @@
-# Shaka Player Gap Jumping
-
-
-## Overview
-
-Gap jumping is a feature to automatically jump over gaps (i.e. missing content)
-in a stream.  There are several cases where content may not be present.  This
-missing content can cause gaps in the video which will cause the player to stop,
-waiting for content that may never exist.  Gap jumping is one of the most
-requested features by developers.
-
-There are two kinds of gaps we need to consider: gaps in the manifest and gaps
-in the media itself.  Gaps in the manifest can be fixed by simply adjusting the
-start and end times of the segments.  We already adjust the segment index to
-make the segments continuous.  Gaps in the media cannot be detected early (since
-the gaps may not appear in the manifest); they can only be detected once the
-media has been appended to the MediaSource and the browser gives us a gap in the
-buffered ranges.
-
-## Background
-
-There have been a number of bugs filed asking for this feature.
-
-#### [#180](https://github.com/shaka-project/shaka-player/issues/180)
-One of the first bugs asking for gap jumping.  The author talks about how live
-streams can commonly lose source content (e.g. from network outages or weather).
-This can cause the packagers to introduce gaps in either the media segments or
-the manifest.
-
-#### [#555](https://github.com/shaka-project/shaka-player/issues/555)
-This one is also asking about live streams and outages.  The author discusses
-several options for dealing with interruptions in the live streams.  The
-suggestions were:
-
-- Use 404s to indicate a segment does not exist on the server.
-- Use “short Periods” (a Period with no content, but @duration) to indicate a gap.
-- Fill with dummy content.
-
-It is brought up that using 404 for missing segments can cause problems since we
-can’t tell if a segment will never be available or is just not created yet.
-Also that dummy content is usually generated by the server; however, the author
-notes that this may not be feasible.
-
-#### [#661](https://github.com/shaka-project/shaka-player/issues/661)
-This content with small gaps in the media that result in playback stalling.
-Chrome and Firefox will actually play through the gap, but we don’t allow it
-since it wouldn’t work on Safari.
-
-
-## Design
-
-If there are gaps in the media (e.g. missing segments), they should not appear
-in the manifest.  If there are missing Periods, then the @start attribute should
-appear in the later Period to indicate a gap.  If there are gaps in the
-manifest, they will be logged and removed by the manifest parser.  Internally,
-the segment index will be continuous.  Even if there is a whole Period missing
-that is minutes long, the segment index will be continuous.  This means that the
-previous Period will be extended to cover the gap and the last segment of that
-Period will also be extended.
-
-Keeping the segment index continuous allows most gap jumping logic to be in
-Playhead.  StreamingEngine will not know about gaps and will simply buffer
-segments like before.  It will buffer segments independently of whether there
-are gaps in the media.  Then if Playhead detects a gap in the media, it will
-jump it there.
-
-There are two kinds of gaps: small gaps that may not be noticeable (and may be
-jumped automatically), and large gaps caused by missing segments in live
-streams.  Small gaps (less than 0.5 seconds) should be jumped automatically on
-all browsers to provide seamless playback.  Larger gaps should be identified and
-sent to the app to make a decision.  If the app wants to (through a
-configuration parameter), we will jump those gaps also.  Additionally, we should
-gracefully handle attempted seeks into gaps (for both buffered and unbuffered
-seeks).
-
-### Configuration
-
-- `.streaming.smallGapLimit` (default 0.5) the threshold (in seconds) for a gap
-  to be considered small and jumped automatically.
-- `.streaming.jumpLargeGaps` (default false) if true, automatically jump large
-  gaps. (see event below)
-
-### Small vs Large Gaps
-
-To support gap jumping across browsers, we will jump small gaps on all browsers
-without user interaction.  These gaps should be small so they do not interrupt
-playback visually.  Larger gaps can be optionally jumped, but we will tell the
-app about it first.
-
-There will be a new event `largegap`.  When the playhead enters a large gap, the
-video will be paused, but we won’t enter a buffering state.  We will then fire
-the event to the app, giving it the current time and the start and end time of
-the gap.
-
-If `jumpLargeGaps` is set, we will use the default action of the event to get
-feedback from the event listeners.  The “default” action here is to jump the
-gap.  If the event handlers call `preventDefault()`, we will not jump this gap.
-If `jumpLargeGaps` is not set, we will still fire the event, but never jump the
-gap ourselves.
-
-### Manifest Parser
-
-The manifest parser should remove all gaps from the index.  The segment index
-should be continuous, even for large gaps.  We are not going to support “empty
-periods”; all Period elements should have content.  However, there can be gaps
-between segments or between Period elements.  If the gap is larger than a
-threshold, a warning is printed.
-
-### Streaming Engine
-
-StreamingEngine will not require any changes.  Since the segment index is
-continuous, it will not see any gaps and just buffer like normal.  We will need
-to modify the buffering logic a little.  We will calculate the amount buffered
-based on the content buffered (i.e. we will ignore the time in the gap).  This
-ensures smooth playback with gap jumping.
-
-Like now, it will continue buffering a sequence of segments from the index.  It
-will only buffer segments in media order, waiting for any segments that appear
-in the index but are not ready on the server (404).  This ensures that any gap
-in the buffered ranges is caused by gaps in the content, not by content that
-will be available later.
-
-We already fetch the segment before the target time when seeking.  We also only
-adjust the end time of a segment, so the start time is “close” to the real time.
-This means that when we seek, there will always be content buffered before the
-playhead.  Once we have buffered past the playhead, we will know if we have
-seeked into a gap.
-
-### Playhead
-
-The Playhead will hold the logic for gap jumping.  When the video plays into a
-gap, the browser will do two things: (1) fire a `waiting` event and (2) change
-the readyState to 2 (`HAVE_CURRENT_FRAME`) or 1 (`HAVE_METADATA`) if this was a
-seek.  To handle this, the Playhead will listen to the `waiting` event and
-update the current time to just past the gap.
-
-When we seek, StreamingEngine will clear the buffer.  This will cause a
-`waiting` event to fire,  which we ignore since nothing will be buffered.  Once
-StreamingEngine starts buffering new content, we need to determine if we are
-still in a gap.  If we are inside a gap, the ready state will be 1 or 2 (it will
-be 3 or 4 while playing).  We will poll the ready state and if it is 1 or 2, we
-are inside (or near) a gap and will need to jump it.  If the ready state is 3 or
-4, we can play and we don’t need to do anything more now.
-
-Playhead will only change the current time if we are in a gap, or close to it.
-If the first buffered range is slightly ahead of the playhead, we will jump it;
-it will also jump if there are multiple buffered ranges and the playhead is
-close to a gap.
-
-Playhead will also handle firing the event for large gaps.  Event firing is
-synchronous, so Playhead will fire the event and then jump the gap if needed.