Source: lib/media/time_ranges_utils.js

  1. /**
  2.  * @license
  3.  * Copyright 2016 Google Inc.
  4.  *
  5.  * Licensed under the Apache License, Version 2.0 (the "License");
  6.  * you may not use this file except in compliance with the License.
  7.  * You may obtain a copy of the License at
  8.  *
  9.  *     http://www.apache.org/licenses/LICENSE-2.0
  10.  *
  11.  * Unless required by applicable law or agreed to in writing, software
  12.  * distributed under the License is distributed on an "AS IS" BASIS,
  13.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.  * See the License for the specific language governing permissions and
  15.  * limitations under the License.
  16.  */
  18. goog.provide('shaka.media.TimeRangesUtils');
  21. /**
  22.  * @namespace shaka.media.TimeRangesUtils
  23.  * @summary A set of utility functions for dealing with TimeRanges objects.
  24.  */
  27. /**
  28.  * Gets the first timestamp in buffer.
  29.  *
  30.  * @param {TimeRanges} b
  31.  * @return {?number} The first buffered timestamp, in seconds, if |buffered|
  32.  *   is non-empty; otherwise, return null.
  33.  */
  34. shaka.media.TimeRangesUtils.bufferStart = function(b) {
  35.   if (!b) return null;
  36.   // Workaround Safari bug: https://goo.gl/EDRCoZ
  37.   if (b.length == 1 && b.end(0) - b.start(0) < 1e-6) return null;
  38.   // Workaround Edge bug: https://goo.gl/BtxKgb
  39.   if (b.length == 1 && b.start(0) < 0) return 0;
  40.   return b.length ? b.start(0) : null;
  41. };
  44. /**
  45.  * Gets the last timestamp in buffer.
  46.  *
  47.  * @param {TimeRanges} b
  48.  * @return {?number} The last buffered timestamp, in seconds, if |buffered|
  49.  *   is non-empty; otherwise, return null.
  50.  */
  51. shaka.media.TimeRangesUtils.bufferEnd = function(b) {
  52.   if (!b) return null;
  53.   // Workaround Safari bug: https://goo.gl/EDRCoZ
  54.   if (b.length == 1 && b.end(0) - b.start(0) < 1e-6) return null;
  55.   return b.length ? b.end(b.length - 1) : null;
  56. };
  59. /**
  60.  * Determines if the given time is inside a buffered range.  This includes gaps,
  61.  * meaning if the playhead is in a gap, it is considered buffered.
  62.  *
  63.  * @param {TimeRanges} b
  64.  * @param {number} time
  65.  * @return {boolean}
  66.  */
  67. shaka.media.TimeRangesUtils.isBuffered = function(b, time) {
  68.   if (!b || !b.length) return false;
  69.   // Workaround Safari bug: https://goo.gl/EDRCoZ
  70.   if (b.length == 1 && b.end(0) - b.start(0) < 1e-6) return false;
  72.   return time >= b.start(0) && time <= b.end(b.length - 1);
  73. };
  76. /**
  77.  * Computes how far ahead of the given timestamp is buffered.  To provide smooth
  78.  * playback while jumping gaps, we don't include the gaps when calculating this.
  79.  * This only includes the amount of content that is buffered.
  80.  *
  81.  * @param {TimeRanges} b
  82.  * @param {number} time
  83.  * @return {number} The number of seconds buffered, in seconds, ahead of the
  84.  *   given time.
  85.  */
  86. shaka.media.TimeRangesUtils.bufferedAheadOf = function(b, time) {
  87.   if (!b || !b.length) return 0;
  88.   // Workaround Safari bug: https://goo.gl/EDRCoZ
  89.   if (b.length == 1 && b.end(0) - b.start(0) < 1e-6) return 0;
  91.   // NOTE: On IE11, buffered ranges may show appended data before the associated
  92.   // append operation is complete.
  94.   // We calculate buffered amount by ONLY accounting for the content buffered
  95.   // (i.e. we ignore the times of the gaps).  We also buffer through all gaps.
  96.   // So start at the end and add up all buffers until |time|.
  97.   var result = 0;
  98.   for (var i = b.length - 1; i >= 0 && b.end(i) > time; --i) {
  99.     result += b.end(i) - Math.max(b.start(i), time);
  100.   }
  102.   return result;
  103. };
  106. /**
  107.  * Determines if the given time is inside a gap between buffered ranges.  If it
  108.  * is, this returns the index of the buffer that is *ahead* of the gap.
  109.  *
  110.  * @param {TimeRanges} b
  111.  * @param {number} time
  112.  * @return {?number} The index of the buffer after the gap, or null if not in a
  113.  *   gap.
  114.  */
  115. shaka.media.TimeRangesUtils.getGapIndex = function(b, time) {
  116.   if (!b || !b.length) return null;
  117.   // Workaround Safari bug: https://goo.gl/EDRCoZ
  118.   if (b.length == 1 && b.end(0) - b.start(0) < 1e-6) return null;
  120.   // IE/Edge stops 0.5 seconds before a gap, so it needs a much larger
  121.   // threshold, but we don't want to punish other browsers that stop closer.
  122.   // See: https://goo.gl/cuAcYd
  123.   var threshold = 0.1;
  124.   if (/(Edge\/|Trident\/|Tizen)/.test(navigator.userAgent))
  125.     threshold = 0.5;
  127.   for (var i = 0; i < b.length; i++) {
  128.     if (b.start(i) > time && (i == 0 || b.end(i - 1) - time <= threshold)) {
  129.       return i;
  130.     }
  131.   }
  133.   return null;
  134. };