dashjs
Version:
A reference client implementation for the playback of MPEG DASH via Javascript and compliant browsers.
1,286 lines • 83.5 kB
HTML
<!DOCTYPE html><html lang="en" style="font-size:16px"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><link rel="icon" href="https://dashif.org/img/favicon.ico"><link type="text/css" rel="stylesheet" href="jsdoc-custom.css"><title>Source: streaming/controllers/BufferController.js</title><!--[if lt IE 9]>
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
<![endif]--><script src="scripts/third-party/hljs.js" defer="defer"></script><script src="scripts/third-party/hljs-line-num.js" defer="defer"></script><script src="scripts/third-party/popper.js" defer="defer"></script><script src="scripts/third-party/tippy.js" defer="defer"></script><script src="scripts/third-party/tocbot.min.js"></script><script>var baseURL="/",locationPathname="";baseURL=(locationPathname=document.location.pathname).substr(0,locationPathname.lastIndexOf("/")+1)</script><link rel="stylesheet" href="styles/clean-jsdoc-theme.min.css"><svg aria-hidden="true" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="display:none"><defs><symbol id="copy-icon" viewbox="0 0 488.3 488.3"><g><path d="M314.25,85.4h-227c-21.3,0-38.6,17.3-38.6,38.6v325.7c0,21.3,17.3,38.6,38.6,38.6h227c21.3,0,38.6-17.3,38.6-38.6V124 C352.75,102.7,335.45,85.4,314.25,85.4z M325.75,449.6c0,6.4-5.2,11.6-11.6,11.6h-227c-6.4,0-11.6-5.2-11.6-11.6V124 c0-6.4,5.2-11.6,11.6-11.6h227c6.4,0,11.6,5.2,11.6,11.6V449.6z"/><path d="M401.05,0h-227c-21.3,0-38.6,17.3-38.6,38.6c0,7.5,6,13.5,13.5,13.5s13.5-6,13.5-13.5c0-6.4,5.2-11.6,11.6-11.6h227 c6.4,0,11.6,5.2,11.6,11.6v325.7c0,6.4-5.2,11.6-11.6,11.6c-7.5,0-13.5,6-13.5,13.5s6,13.5,13.5,13.5c21.3,0,38.6-17.3,38.6-38.6 V38.6C439.65,17.3,422.35,0,401.05,0z"/></g></symbol><symbol id="search-icon" viewBox="0 0 512 512"><g><g><path d="M225.474,0C101.151,0,0,101.151,0,225.474c0,124.33,101.151,225.474,225.474,225.474 c124.33,0,225.474-101.144,225.474-225.474C450.948,101.151,349.804,0,225.474,0z M225.474,409.323 c-101.373,0-183.848-82.475-183.848-183.848S124.101,41.626,225.474,41.626s183.848,82.475,183.848,183.848 S326.847,409.323,225.474,409.323z"/></g></g><g><g><path d="M505.902,476.472L386.574,357.144c-8.131-8.131-21.299-8.131-29.43,0c-8.131,8.124-8.131,21.306,0,29.43l119.328,119.328 c4.065,4.065,9.387,6.098,14.715,6.098c5.321,0,10.649-2.033,14.715-6.098C514.033,497.778,514.033,484.596,505.902,476.472z"/></g></g></symbol><symbol id="font-size-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11.246 15H4.754l-2 5H.6L7 4h2l6.4 16h-2.154l-2-5zm-.8-2L8 6.885 5.554 13h4.892zM21 12.535V12h2v8h-2v-.535a4 4 0 1 1 0-6.93zM19 18a2 2 0 1 0 0-4 2 2 0 0 0 0 4z"/></symbol><symbol id="add-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11 11V5h2v6h6v2h-6v6h-2v-6H5v-2z"/></symbol><symbol id="minus-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M5 11h14v2H5z"/></symbol><symbol id="dark-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M10 7a7 7 0 0 0 12 4.9v.1c0 5.523-4.477 10-10 10S2 17.523 2 12 6.477 2 12 2h.1A6.979 6.979 0 0 0 10 7zm-6 5a8 8 0 0 0 15.062 3.762A9 9 0 0 1 8.238 4.938 7.999 7.999 0 0 0 4 12z"/></symbol><symbol id="light-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 18a6 6 0 1 1 0-12 6 6 0 0 1 0 12zm0-2a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM11 1h2v3h-2V1zm0 19h2v3h-2v-3zM3.515 4.929l1.414-1.414L7.05 5.636 5.636 7.05 3.515 4.93zM16.95 18.364l1.414-1.414 2.121 2.121-1.414 1.414-2.121-2.121zm2.121-14.85l1.414 1.415-2.121 2.121-1.414-1.414 2.121-2.121zM5.636 16.95l1.414 1.414-2.121 2.121-1.414-1.414 2.121-2.121zM23 11v2h-3v-2h3zM4 11v2H1v-2h3z"/></symbol><symbol id="reset-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M18.537 19.567A9.961 9.961 0 0 1 12 22C6.477 22 2 17.523 2 12S6.477 2 12 2s10 4.477 10 10c0 2.136-.67 4.116-1.81 5.74L17 12h3a8 8 0 1 0-2.46 5.772l.997 1.795z"/></symbol><symbol id="down-icon" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M12.7803 6.21967C13.0732 6.51256 13.0732 6.98744 12.7803 7.28033L8.53033 11.5303C8.23744 11.8232 7.76256 11.8232 7.46967 11.5303L3.21967 7.28033C2.92678 6.98744 2.92678 6.51256 3.21967 6.21967C3.51256 5.92678 3.98744 5.92678 4.28033 6.21967L8 9.93934L11.7197 6.21967C12.0126 5.92678 12.4874 5.92678 12.7803 6.21967Z"></path></symbol><symbol id="codepen-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M16.5 13.202L13 15.535v3.596L19.197 15 16.5 13.202zM14.697 12L12 10.202 9.303 12 12 13.798 14.697 12zM20 10.869L18.303 12 20 13.131V10.87zM19.197 9L13 4.869v3.596l3.5 2.333L19.197 9zM7.5 10.798L11 8.465V4.869L4.803 9 7.5 10.798zM4.803 15L11 19.131v-3.596l-3.5-2.333L4.803 15zM4 13.131L5.697 12 4 10.869v2.262zM2 9a1 1 0 0 1 .445-.832l9-6a1 1 0 0 1 1.11 0l9 6A1 1 0 0 1 22 9v6a1 1 0 0 1-.445.832l-9 6a1 1 0 0 1-1.11 0l-9-6A1 1 0 0 1 2 15V9z"/></symbol><symbol id="close-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 10.586l4.95-4.95 1.414 1.414-4.95 4.95 4.95 4.95-1.414 1.414-4.95-4.95-4.95 4.95-1.414-1.414 4.95-4.95-4.95-4.95L7.05 5.636z"/></symbol><symbol id="menu-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M3 4h18v2H3V4zm0 7h18v2H3v-2zm0 7h18v2H3v-2z"/></symbol></defs></svg></head><body data-theme="light"><div class="sidebar-container"><div class="sidebar" id="sidebar"><a href="/" class="sidebar-title sidebar-title-anchor">Home</a><div class="sidebar-items-container"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-DashAdapter.html">DashAdapter</a></div><div class="sidebar-section-children"><a href="module-DashMetrics.html">DashMetrics</a></div><div class="sidebar-section-children"><a href="module-MediaPlayer.html">MediaPlayer</a></div><div class="sidebar-section-children"><a href="module-OfflineController.html">OfflineController</a></div><div class="sidebar-section-children"><a href="module-ProtectionController.html">ProtectionController</a></div><div class="sidebar-section-children"><a href="module-Settings.html">Settings</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="Errors.html">Errors</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html">MediaPlayerEvents</a></div><div class="sidebar-section-children"><a href="MediaPlayerModel.html">MediaPlayerModel</a></div><div class="sidebar-section-children"><a href="MetricsReportingEvents.html">MetricsReportingEvents</a></div><div class="sidebar-section-children"><a href="MssErrors.html">MssErrors</a></div><div class="sidebar-section-children"><a href="OfflineErrors.html">OfflineErrors</a></div><div class="sidebar-section-children"><a href="OfflineEvents.html">OfflineEvents</a></div><div class="sidebar-section-children"><a href="ProtectionErrors.html">ProtectionErrors</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html">ProtectionEvents</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-events"><div>Events</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:ADAPTATION_SET_REMOVED_NO_CAPABILITIES">ADAPTATION_SET_REMOVED_NO_CAPABILITIES</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:AST_IN_FUTURE">AST_IN_FUTURE</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:BASE_URLS_UPDATED">BASE_URLS_UPDATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:BUFFER_EMPTY">BUFFER_EMPTY</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:BUFFER_LEVEL_STATE_CHANGED">BUFFER_LEVEL_STATE_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:BUFFER_LEVEL_UPDATED">BUFFER_LEVEL_UPDATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:BUFFER_LOADED">BUFFER_LOADED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CAN_PLAY">CAN_PLAY</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CAN_PLAY_THROUGH">CAN_PLAY_THROUGH</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CAPTION_CONTAINER_RESIZE">CAPTION_CONTAINER_RESIZE</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CAPTION_RENDERED">CAPTION_RENDERED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CONFORMANCE_VIOLATION">CONFORMANCE_VIOLATION</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CONTENT_STEERING_REQUEST_COMPLETED">CONTENT_STEERING_REQUEST_COMPLETED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CUE_ENTER">CUE_ENTER</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CUE_ENTER">CUE_ENTER</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:DVB_FONT_DOWNLOAD_ADDED">DVB_FONT_DOWNLOAD_ADDED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:DVB_FONT_DOWNLOAD_COMPLETE">DVB_FONT_DOWNLOAD_COMPLETE</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:DVB_FONT_DOWNLOAD_FAILED">DVB_FONT_DOWNLOAD_FAILED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:DYNAMIC_TO_STATIC">DYNAMIC_TO_STATIC</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:ERROR">ERROR</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:EVENT_MODE_ON_RECEIVE">EVENT_MODE_ON_RECEIVE</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:EVENT_MODE_ON_START">EVENT_MODE_ON_START</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:FRAGMENT_LOADING_ABANDONED">FRAGMENT_LOADING_ABANDONED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:FRAGMENT_LOADING_COMPLETED">FRAGMENT_LOADING_COMPLETED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:FRAGMENT_LOADING_PROGRESS">FRAGMENT_LOADING_PROGRESS</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:FRAGMENT_LOADING_STARTED">FRAGMENT_LOADING_STARTED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:INBAND_PRFT">INBAND_PRFT</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:LOG">LOG</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:MANIFEST_LOADED">MANIFEST_LOADED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:MANIFEST_LOADING_FINISHED">MANIFEST_LOADING_FINISHED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:MANIFEST_LOADING_STARTED">MANIFEST_LOADING_STARTED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:MANIFEST_VALIDITY_CHANGED">MANIFEST_VALIDITY_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:METRIC_ADDED">METRIC_ADDED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:METRIC_CHANGED">METRIC_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:METRIC_UPDATED">METRIC_UPDATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:METRICS_CHANGED">METRICS_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PERIOD_SWITCH_COMPLETED">PERIOD_SWITCH_COMPLETED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PERIOD_SWITCH_STARTED">PERIOD_SWITCH_STARTED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_ENDED">PLAYBACK_ENDED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_ERROR">PLAYBACK_ERROR</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_LOADED_DATA">PLAYBACK_LOADED_DATA</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_METADATA_LOADED">PLAYBACK_METADATA_LOADED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_NOT_ALLOWED">PLAYBACK_NOT_ALLOWED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_PAUSED">PLAYBACK_PAUSED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_PLAYING">PLAYBACK_PLAYING</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_PROGRESS">PLAYBACK_PROGRESS</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_RATE_CHANGED">PLAYBACK_RATE_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_SEEKED">PLAYBACK_SEEKED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_SEEKING">PLAYBACK_SEEKING</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_STALLED">PLAYBACK_STALLED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_STARTED">PLAYBACK_STARTED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_TIME_UPDATED">PLAYBACK_TIME_UPDATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_VOLUME_CHANGED">PLAYBACK_VOLUME_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_WAITING">PLAYBACK_WAITING</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:QUALITY_CHANGE_RENDERED">QUALITY_CHANGE_RENDERED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:QUALITY_CHANGE_REQUESTED">QUALITY_CHANGE_REQUESTED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:REPRESENTATION_SWITCH">REPRESENTATION_SWITCH</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_ACTIVATED">STREAM_ACTIVATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_DEACTIVATED">STREAM_DEACTIVATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_INITIALIZED">STREAM_INITIALIZED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_INITIALIZING">STREAM_INITIALIZING</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_TEARDOWN_COMPLETE">STREAM_TEARDOWN_COMPLETE</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_UPDATED">STREAM_UPDATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:TEXT_TRACK_ADDED">TEXT_TRACK_ADDED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:TEXT_TRACKS_ADDED">TEXT_TRACKS_ADDED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:THROUGHPUT_MEASUREMENT_STORED">THROUGHPUT_MEASUREMENT_STORED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:TRACK_CHANGE_RENDERED">TRACK_CHANGE_RENDERED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:TTML_PARSED">TTML_PARSED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:TTML_TO_PARSE">TTML_TO_PARSE</a></div><div class="sidebar-section-children"><a href="MetricsReportingEvents.html#event:CMCD_DATA_GENERATED">CMCD_DATA_GENERATED</a></div><div class="sidebar-section-children"><a href="OfflineEvents.html#event:OFFLINE_RECORD_FINISHED">OFFLINE_RECORD_FINISHED</a></div><div class="sidebar-section-children"><a href="OfflineEvents.html#event:OFFLINE_RECORD_LOADEDMETADATA">OFFLINE_RECORD_LOADEDMETADATA</a></div><div class="sidebar-section-children"><a href="OfflineEvents.html#event:OFFLINE_RECORD_STARTED">OFFLINE_RECORD_STARTED</a></div><div class="sidebar-section-children"><a href="OfflineEvents.html#event:OFFLINE_RECORD_STOPPED">OFFLINE_RECORD_STOPPED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_ADDED">KEY_ADDED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_ERROR">KEY_ERROR</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_MESSAGE">KEY_MESSAGE</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_SESSION_CLOSED">KEY_SESSION_CLOSED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_SESSION_CREATED">KEY_SESSION_CREATED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_SESSION_REMOVED">KEY_SESSION_REMOVED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_STATUSES_CHANGED">KEY_STATUSES_CHANGED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_SYSTEM_ACCESS_COMPLETE">KEY_SYSTEM_ACCESS_COMPLETE</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_SYSTEM_SELECTED">KEY_SYSTEM_SELECTED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:LICENSE_REQUEST_COMPLETE">LICENSE_REQUEST_COMPLETE</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:LICENSE_REQUEST_SENDING">LICENSE_REQUEST_SENDING</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:PROTECTION_CREATED">PROTECTION_CREATED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:PROTECTION_DESTROYED">PROTECTION_DESTROYED</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#LICENSE_SERVER_MANIFEST_CONFIGURATIONS">LICENSE_SERVER_MANIFEST_CONFIGURATIONS</a></div><div class="sidebar-section-children"><a href="global.html#MediaType">MediaType</a></div></div></div></div></div><div class="navbar-container" id="VuAckcnZhf"><nav class="navbar"><div class="navbar-left-items"></div><div class="navbar-right-items"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#dark-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div><nav></nav></nav></div><div class="toc-container"><div class="toc-content"><span class="bold">On this page</span><div id="eed4d2a0bfd64539bb9df78095dec881"></div></div></div><div class="body-wrapper"><div class="main-content"><div class="main-wrapper"><section id="source-page" class="source-page"><header><h1 id="title" class="has-anchor">streaming_controllers_BufferController.js</h1></header><article><pre class="prettyprint source lang-js"><code>/**
* The copyright in this software is being made available under the BSD License,
* included below. This software may be subject to other third party and contributor
* rights, including patent rights, and no such rights are granted under this license.
*
* Copyright (c) 2013, Dash Industry Forum.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
* * Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation and/or
* other materials provided with the distribution.
* * Neither the name of Dash Industry Forum nor the names of its
* contributors may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
* INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
import Constants from '../constants/Constants';
import MetricsConstants from '../constants/MetricsConstants';
import FragmentModel from '../models/FragmentModel';
import SourceBufferSink from '../SourceBufferSink';
import PreBufferSink from '../PreBufferSink';
import EventBus from '../../core/EventBus';
import Events from '../../core/events/Events';
import FactoryMaker from '../../core/FactoryMaker';
import Debug from '../../core/Debug';
import InitCache from '../utils/InitCache';
import DashJSError from '../vo/DashJSError';
import Errors from '../../core/errors/Errors';
import {HTTPRequest} from '../vo/metrics/HTTPRequest';
import MediaPlayerEvents from '../../streaming/MediaPlayerEvents';
const BUFFER_END_THRESHOLD = 0.5;
const BUFFER_RANGE_CALCULATION_THRESHOLD = 0.01;
const QUOTA_EXCEEDED_ERROR_CODE = 22;
const BUFFER_CONTROLLER_TYPE = 'BufferController';
function BufferController(config) {
config = config || {};
const context = this.context;
const eventBus = EventBus(context).getInstance();
const errHandler = config.errHandler;
const fragmentModel = config.fragmentModel;
const representationController = config.representationController;
const adapter = config.adapter;
const textController = config.textController;
const abrController = config.abrController;
const playbackController = config.playbackController;
const streamInfo = config.streamInfo;
const type = config.type;
const settings = config.settings;
let instance,
logger,
isBufferingCompleted,
bufferLevel,
criticalBufferLevel,
mediaSource,
maxAppendedIndex,
maximumIndex,
sourceBufferSink,
dischargeBuffer,
isPrebuffering,
dischargeFragments,
bufferState,
appendedBytesInfo,
wallclockTicked,
isPruningInProgress,
isQuotaExceeded,
initCache,
pendingPruningRanges,
replacingBuffer,
seekTarget;
function setup() {
logger = Debug(context).getInstance().getLogger(instance);
initCache = InitCache(context).getInstance();
resetInitialSettings();
}
/**
* Initialize the BufferController. Sets the media source and registers the event handlers.
* @param {object} mediaSource
*/
function initialize(mediaSource) {
setMediaSource(mediaSource);
eventBus.on(Events.INIT_FRAGMENT_LOADED, _onInitFragmentLoaded, instance);
eventBus.on(Events.MEDIA_FRAGMENT_LOADED, _onMediaFragmentLoaded, instance);
eventBus.on(Events.WALLCLOCK_TIME_UPDATED, _onWallclockTimeUpdated, instance);
eventBus.on(MediaPlayerEvents.PLAYBACK_PLAYING, _onPlaybackPlaying, instance);
eventBus.on(MediaPlayerEvents.PLAYBACK_PROGRESS, _onPlaybackProgression, instance);
eventBus.on(MediaPlayerEvents.PLAYBACK_TIME_UPDATED, _onPlaybackProgression, instance);
eventBus.on(MediaPlayerEvents.PLAYBACK_RATE_CHANGED, _onPlaybackRateChanged, instance);
eventBus.on(MediaPlayerEvents.PLAYBACK_STALLED, _onPlaybackStalled, instance);
}
/**
* Returns the stream id
* @return {string}
*/
function getStreamId() {
return streamInfo.id;
}
/**
* Returns the media type
* @return {type}
*/
function getType() {
return type;
}
/**
* Returns the type of the BufferController. We distinguish between standard buffer controllers and buffer controllers related to texttracks.
* @return {string}
*/
function getBufferControllerType() {
return BUFFER_CONTROLLER_TYPE;
}
/**
* Sets the mediasource.
* @param {object} value
* @param {object} mediaInfo
*/
function setMediaSource(value, mediaInfo = null) {
return new Promise((resolve, reject) => {
mediaSource = value;
// if we have a prebuffer, we should prepare to discharge it, and make a new sourceBuffer ready
if (sourceBufferSink && mediaInfo && typeof sourceBufferSink.discharge === 'function') {
dischargeBuffer = sourceBufferSink;
createBufferSink(mediaInfo)
.then(() => {
resolve();
})
.catch((e) => {
reject(e);
})
} else {
resolve();
}
})
}
/**
* Get the RepresentationInfo for a certain quality.
* @param {number} quality
* @return {object}
* @private
*/
function _getRepresentationInfo(quality) {
return adapter.convertRepresentationToRepresentationInfo(representationController.getRepresentationForQuality(quality));
}
/**
* Creates a SourceBufferSink object
* @param {object} mediaInfo
* @param {array} oldBufferSinks
* @return {Promise<Object>} SourceBufferSink
*/
function createBufferSink(mediaInfo, oldBufferSinks = []) {
return new Promise((resolve, reject) => {
if (!initCache || !mediaInfo) {
resolve(null);
return;
}
if (mediaSource) {
isPrebuffering = false;
_initializeSinkForMseBuffering(mediaInfo, oldBufferSinks)
.then((sink) => {
resolve(sink);
})
.catch((e) => {
reject(e);
})
} else {
isPrebuffering = true;
_initializeSinkForPrebuffering()
.then((sink) => {
resolve(sink);
})
.catch((e) => {
reject(e);
})
}
});
}
function _initializeSinkForPrebuffering() {
return new Promise((resolve, reject) => {
const requiredQuality = abrController.getQualityFor(type, streamInfo.id);
sourceBufferSink = PreBufferSink(context).create(_onAppended.bind(this));
updateBufferTimestampOffset(_getRepresentationInfo(requiredQuality))
.then(() => {
resolve(sourceBufferSink);
})
.catch(() => {
reject();
})
})
}
function _initializeSinkForMseBuffering(mediaInfo, oldBufferSinks) {
return new Promise((resolve, reject) => {
const requiredQuality = abrController.getQualityFor(type, streamInfo.id);
sourceBufferSink = SourceBufferSink(context).create({
mediaSource,
textController,
eventBus
});
_initializeSink(mediaInfo, oldBufferSinks, requiredQuality)
.then(() => {
return updateBufferTimestampOffset(_getRepresentationInfo(requiredQuality));
})
.then(() => {
resolve(sourceBufferSink);
})
.catch((e) => {
logger.fatal('Caught error on create SourceBuffer: ' + e);
errHandler.error(new DashJSError(Errors.MEDIASOURCE_TYPE_UNSUPPORTED_CODE, Errors.MEDIASOURCE_TYPE_UNSUPPORTED_MESSAGE + type));
reject(e);
});
})
}
function _initializeSink(mediaInfo, oldBufferSinks, requiredQuality) {
const selectedRepresentation = _getRepresentationInfo(requiredQuality);
if (oldBufferSinks && oldBufferSinks[type] && (type === Constants.VIDEO || type === Constants.AUDIO)) {
return sourceBufferSink.initializeForStreamSwitch(mediaInfo, selectedRepresentation, oldBufferSinks[type]);
} else {
return sourceBufferSink.initializeForFirstUse(streamInfo, mediaInfo, selectedRepresentation);
}
}
function dischargePreBuffer() {
if (sourceBufferSink && dischargeBuffer && typeof dischargeBuffer.discharge === 'function') {
const ranges = dischargeBuffer.getAllBufferRanges();
if (ranges.length > 0) {
let rangeStr = 'Beginning ' + type + 'PreBuffer discharge, adding buffer for:';
for (let i = 0; i < ranges.length; i++) {
rangeStr += ' start: ' + ranges.start(i) + ', end: ' + ranges.end(i) + ';';
}
logger.debug(rangeStr);
} else {
logger.debug('PreBuffer discharge requested, but there were no media segments in the PreBuffer.');
}
//A list of fragments to supress bytesAppended events for. This makes transferring from a prebuffer to a sourcebuffer silent.
dischargeFragments = [];
let chunks = dischargeBuffer.discharge();
let lastInit = null;
for (let j = 0; j < chunks.length; j++) {
const chunk = chunks[j];
if (chunk.segmentType !== HTTPRequest.INIT_SEGMENT_TYPE) {
const initChunk = initCache.extract(chunk.streamId, chunk.representationId);
if (initChunk) {
if (lastInit !== initChunk) {
dischargeFragments.push(initChunk);
sourceBufferSink.append(initChunk);
lastInit = initChunk;
}
}
}
dischargeFragments.push(chunk);
sourceBufferSink.append(chunk);
}
dischargeBuffer.reset();
dischargeBuffer = null;
}
}
/**
* Callback handler when init segment has been loaded. Based on settings, the init segment is saved to the cache, and appended to the buffer.
* @param {object} e
* @private
*/
function _onInitFragmentLoaded(e) {
if (settings.get().streaming.cacheInitSegments) {
logger.info('Init fragment finished loading saving to', type + '\'s init cache');
initCache.save(e.chunk);
}
logger.debug('Append Init fragment', type, ' with representationId:', e.chunk.representationId, ' and quality:', e.chunk.quality, ', data size:', e.chunk.bytes.byteLength);
_appendToBuffer(e.chunk);
}
/**
* Append the init segment for a certain representation to the buffer. If the init segment is cached we take the one from the cache. Otherwise the function returns false and the segment has to be requested again.
* @param {string} representationId
* @return {boolean}
*/
function appendInitSegmentFromCache(representationId) {
// Get init segment from cache
const chunk = initCache.extract(streamInfo.id, representationId);
if (!chunk) {
// Init segment not in cache, shall be requested
return false;
}
// Append init segment into buffer
logger.info('Append Init fragment', type, ' with representationId:', chunk.representationId, ' and quality:', chunk.quality, ', data size:', chunk.bytes.byteLength);
_appendToBuffer(chunk);
return true;
}
/**
* Calls the _appendToBuffer function to append the segment to the buffer. In case of a track switch the buffer might be cleared.
* @param {object} e
*/
function _onMediaFragmentLoaded(e) {
_appendToBuffer(e.chunk, e.request);
}
/**
* Append data to the MSE buffer using the SourceBufferSink
* @param {object} chunk
* @param {object} request
* @private
*/
function _appendToBuffer(chunk, request = null) {
if (!sourceBufferSink) {
return;
}
sourceBufferSink.append(chunk, request)
.then((e) => {
_onAppended(e);
})
.catch((e) => {
_onAppended(e);
});
if (chunk.mediaInfo.type === Constants.VIDEO) {
_triggerEvent(Events.VIDEO_CHUNK_RECEIVED, { chunk: chunk });
}
}
function _showBufferRanges(ranges) {
if (ranges && ranges.length > 0) {
for (let i = 0, len = ranges.length; i < len; i++) {
logger.debug('Buffered range: ' + ranges.start(i) + ' - ' + ranges.end(i) + ', currentTime = ', playbackController.getTime());
}
}
}
function _onAppended(e) {
if (e.error) {
// If we receive a QUOTA_EXCEEDED_ERROR_CODE we should adjust the target buffer times to avoid this error in the future.
if (e.error.code === QUOTA_EXCEEDED_ERROR_CODE) {
_handleQuotaExceededError();
}
if (e.error.code === QUOTA_EXCEEDED_ERROR_CODE || !hasEnoughSpaceToAppend()) {
logger.warn('Clearing playback buffer to overcome quota exceed situation');
// Notify ScheduleController to stop scheduling until buffer has been pruned
_triggerEvent(Events.QUOTA_EXCEEDED, {
criticalBufferLevel: criticalBufferLevel,
quotaExceededTime: e.chunk.start
});
clearBuffers(getClearRanges());
}
return;
}
// Check if session has not been stopped in the meantime (while last segment was being appended)
if (!sourceBufferSink) return;
_updateBufferLevel();
isQuotaExceeded = false;
appendedBytesInfo = e.chunk;
if (!appendedBytesInfo || !appendedBytesInfo.endFragment) {
return;
}
if (appendedBytesInfo && !isNaN(appendedBytesInfo.index)) {
maxAppendedIndex = Math.max(appendedBytesInfo.index, maxAppendedIndex);
_checkIfBufferingCompleted();
}
const ranges = sourceBufferSink.getAllBufferRanges();
if (appendedBytesInfo.segmentType === HTTPRequest.MEDIA_SEGMENT_TYPE) {
_showBufferRanges(ranges);
_onPlaybackProgression();
_adjustSeekTarget();
}
let suppressAppendedEvent = false;
if (dischargeFragments) {
if (dischargeFragments.indexOf(appendedBytesInfo) > 0) {
suppressAppendedEvent = true;
}
dischargeFragments = null;
}
if (appendedBytesInfo && !suppressAppendedEvent) {
_triggerEvent(Events.BYTES_APPENDED_END_FRAGMENT, {
quality: appendedBytesInfo.quality,
startTime: appendedBytesInfo.start,
index: appendedBytesInfo.index,
bufferedRanges: ranges,
segmentType: appendedBytesInfo.segmentType,
mediaType: type
});
}
}
/**
* In some cases the segment we requested might start at a different time than we initially aimed for. segments timeline/template tolerance.
* We might need to do an internal seek if there is drift.
* @private
*/
function _adjustSeekTarget() {
if (isNaN(seekTarget) || isPrebuffering) return;
// Check buffered data only for audio and video
if (type !== Constants.AUDIO && type !== Constants.VIDEO) {
seekTarget = NaN;
return;
}
// Check if current buffered range already contains seek target (and current video element time)
const currentTime = playbackController.getTime();
const rangeAtCurrenTime = getRangeAt(currentTime, 0);
const rangeAtSeekTarget = getRangeAt(seekTarget, 0);
if (rangeAtCurrenTime && rangeAtSeekTarget && rangeAtCurrenTime.start === rangeAtSeekTarget.start) {
seekTarget = NaN;
return;
}
// Get buffered range corresponding to the seek target
const segmentDuration = representationController.getCurrentRepresentation().segmentDuration;
const range = getRangeAt(seekTarget, segmentDuration);
if (!range) return;
if (settings.get().streaming.buffer.enableSeekDecorrelationFix && Math.abs(currentTime - seekTarget) > segmentDuration) {
// If current video model time is decorrelated from seek target (and appended buffer) then seek video element
// (in case of live streams on some browsers/devices for which we can't set video element time at unavalaible range)
// Check if appended segment is not anterior from seek target (segments timeline/template tolerance)
if (seekTarget <= range.end) {
// Seek video element to seek target or range start if appended buffer starts after seek target (segments timeline/template tolerance)
playbackController.seek(Math.max(seekTarget, range.start), false, true);
}
} else if (currentTime < range.start) {
// If appended buffer starts after seek target (segments timeline/template tolerance) then seek to range start
playbackController.seek(range.start, false, true);
}
}
function _handleQuotaExceededError() {
isQuotaExceeded = true;
criticalBufferLevel = getTotalBufferedTime() * 0.8;
logger.warn('Quota exceeded, Critical Buffer: ' + criticalBufferLevel);
if (criticalBufferLevel > 0) {
// recalculate buffer lengths according to criticalBufferLevel
const bufferToKeep = Math.max(0.2 * criticalBufferLevel, 1);
const bufferAhead = criticalBufferLevel - bufferToKeep;
const bufferTimeAtTopQuality = Math.min(settings.get().streaming.buffer.bufferTimeAtTopQuality, bufferAhead * 0.9);
const bufferTimeAtTopQualityLongForm = Math.min(settings.get().streaming.buffer.bufferTimeAtTopQualityLongForm, bufferAhead * 0.9);
const s = {
streaming: {
buffer: {
bufferToKeep: parseFloat(bufferToKeep.toFixed(5)),
bufferTimeAtTopQuality: parseFloat(bufferTimeAtTopQuality.toFixed(5)),
bufferTimeAtTopQualityLongForm: parseFloat(bufferTimeAtTopQualityLongForm.toFixed(5))
}
}
};
settings.update(s);
}
}
//**********************************************************************
// START Buffer Level, State & Sufficiency Handling.
//**********************************************************************
function prepareForPlaybackSeek() {
if (isBufferingCompleted) {
setIsBufferingCompleted(false);
}
// Abort the current request and empty all possible segments to be appended
return sourceBufferSink.abort();
}
function prepareForReplacementTrackSwitch(codec) {
return new Promise((resolve, reject) => {
sourceBufferSink.abort()
.then(() => {
return updateAppendWindow();
})
.then(() => {
if (settings.get().streaming.buffer.useChangeTypeForTrackSwitch) {
return sourceBufferSink.changeType(codec);
}
return Promise.resolve();
})
.then(() => {
return pruneAllSafely();
})
.then(() => {
setIsBufferingCompleted(false);
resolve();
})
.catch((e) => {
reject(e);
});
});
}
function prepareForForceReplacementQualitySwitch(representationInfo) {
return new Promise((resolve, reject) => {
sourceBufferSink.abort()
.then(() => {
return updateAppendWindow();
})
.then(() => {
return pruneAllSafely();
})
.then(() => {
// In any case we need to update the MSE.timeOffset
return updateBufferTimestampOffset(representationInfo)
})
.then(() => {
setIsBufferingCompleted(false);
resolve();
})
.catch((e) => {
reject(e);
});
});
}
function prepareForNonReplacementTrackSwitch(codec) {
return new Promise((resolve, reject) => {
updateAppendWindow()
.then(() => {
if (settings.get().streaming.buffer.useChangeTypeForTrackSwitch) {
return sourceBufferSink.changeType(codec);
}
return Promise.resolve();
})
.then(() => {
resolve();
})
.catch((e) => {
reject(e);
});
});
}
function pruneAllSafely() {
return new Promise((resolve, reject) => {
let ranges = getAllRangesWithSafetyFactor();
if (!ranges || ranges.length === 0) {
_onPlaybackProgression();
resolve();
return;
}
clearBuffers(ranges)
.then(() => {
resolve();
})
.catch((e) => {
reject(e);
});
});
}
function getAllRangesWithSafetyFactor(seekTime) {
const clearRanges = [];
const ranges = sourceBufferSink.getAllBufferRanges();
// no valid ranges
if (!ranges || ranges.length === 0) {
return clearRanges;
}
// if no target time is provided we clear everyhing
if ((!seekTime && seekTime !== 0) || isNaN(seekTime)) {
clearRanges.push({
start: ranges.start(0),
end: ranges.end(ranges.length - 1) + BUFFER_END_THRESHOLD
});
}
// otherwise we need to calculate the correct pruning range
else {
const behindPruningRange = _getRangeBehindForPruning(seekTime, ranges);
const aheadPruningRange = _getRangeAheadForPruning(seekTime, ranges);
if (behindPruningRange) {
clearRanges.push(behindPruningRange);
}
if (aheadPruningRange) {
clearRanges.push(aheadPruningRange);
}
}
return clearRanges;
}
function _getRangeBehindForPruning(targetTime, ranges) {
const bufferToKeepBehind = settings.get().streaming.buffer.bufferToKeep;
const startOfBuffer = ranges.start(0);
// if we do a seek ahead of the current play position we do need to prune behind the new play position
const behindDiff = targetTime - startOfBuffer;
if (behindDiff > bufferToKeepBehind) {
let rangeEnd = Math.max(0, targetTime - bufferToKeepBehind);
// Ensure we keep full range of current fragment
const currentTimeRequest = fragmentModel.getRequests({
state: FragmentModel.FRAGMENT_MODEL_EXECUTED,
time: targetTime,
threshold: BUFFER_RANGE_CALCULATION_THRESHOLD
})[0];
if (currentTimeRequest) {
rangeEnd = Math.min(currentTimeRequest.startTime, rangeEnd);
}
if (rangeEnd > 0) {
return {
start: startOfBuffer,
end: rangeEnd
};
}
}
return null;
}
function _getRangeAheadForPruning(targetTime, ranges) {
// if we do a seek behind the current play position we do need to prune ahead of the new play position
// we keep everything that is within bufferToKeepAhead but only if the buffer is continuous.
// Otherwise we have gaps once the seek is done which might trigger an unintentional gap jump
const endOfBuffer = ranges.end(ranges.length - 1) + BUFFER_END_THRESHOLD;
const continuousBufferTime = getContinuousBufferTimeForTargetTime(targetTime);
// This is the maximum range we keep ahead
const isLongFormContent = streamInfo.manifestInfo.duration >= settings.get().streaming.buffer.longFormContentDurationThreshold;
const bufferToKeepAhead = isLongFormContent ? settings.get().streaming.buffer.bufferTimeAtTopQualityLongForm : settings.get().streaming.buffer.bufferTimeAtTopQuality;
// Define the start time from which we will prune. If there is no continuous range from the targettime we start immediately at the target time
// Otherwise we set the start point to the end of the continuous range taking the maximum buffer to keep ahead into account
let rangeStart = !isNaN(continuousBufferTime) ? Math.min(continuousBufferTime, targetTime + bufferToKeepAhead) : targetTime;
// Check if we are done buffering, no need to prune then
if (rangeStart >= ranges.end(ranges.length - 1)) {
return null
}
// Ensure we keep full range of current fragment
const currentTimeRequest = fragmentModel.getRequests({
state: FragmentModel.FRAGMENT_MODEL_EXECUTED,
time: targetTime,
threshold: BUFFER_RANGE_CALCULATION_THRESHOLD
})[0];
if (currentTimeRequest) {
rangeStart = Math.max(currentTimeRequest.startTime + currentTimeRequest.duration, rangeStart);
}
// Never remove the contiguous range of targetTime in order to avoid flushes & reenqueues when the user doesn't want it
const avoidCurrentTimeRangePruning = settings.get().streaming.buffer.avoidCurrentTimeRangePruning;
if (avoidCurrentTimeRangePruning) {
for (let i = 0; i < ranges.length; i++) {
if (ranges.start(i) <= targetTime && targetTime <= ranges.end(i)
&& ranges.start(i) <= rangeStart && rangeStart <= ranges.end(i)) {
let oldRangeStart = rangeStart;
if (i + 1 < ranges.length) {
rangeStart = ranges.start(i + 1);
} else {
rangeStart = ranges.end(i) + 1;
}
logger.debug('Buffered range [' + ranges.start(i) + ', ' + ranges.end(i) + '] overlaps with targetTime ' + targetTime + ' and range to be pruned [' + oldRangeStart + ', ' + endOfBuffer + '], using [' + rangeStart + ', ' + endOfBuffer + '] instead' + ((rangeStart < endOfBuffer) ? '' : ' (no actual pruning)'));
break;
}
}
}
if (rangeStart < ranges.end(ranges.length - 1)) {
return {
start: rangeStart,
end: endOfBuffer
};
}
return null;
}
function _onPlaybackProgression() {
if (!replacingBuffer || (type === Constants.TEXT && textController.isTextEnabled())) {
_updateBufferLevel();
}
}
function _onPlaybackStalled() {
checkIfSufficientBuffer();
}
function _onPlaybackPlaying() {
checkIfSufficientBuffer();
seekTarget = NaN;
}
function hasBufferAtTime(time) {
try {
const ranges = sourceBufferSink.getAllBufferRanges();
if (!ranges || ranges.length === 0) {
return false;
}
let i = 0;
while (i < ranges.length) {
const start = ranges.start(i);
const end = ranges.end(i);
if (time >= start && time <= end) {
return true;
}
i += 1;
}
return false
} catch (e) {
logger.error(e);
return false;
}
}
function getRangeAt(time, tolerance) {
if (!sourceBufferSink) {
return null;
}
const ranges = sourceBufferSink.getAllBufferRanges();
let start = 0;
let end = 0;
let firstStart = null;
let lastEnd = null;
let gap = 0;
let len,
i;
const toler = !isNaN(tolerance) ? tolerance : 0.15;
if (ranges !== null && ranges !== undefined) {
for (i = 0, len = ranges.length; i < len; i++) {
start = ranges.start(i);
end = ranges.end(i);
if (firstStart === null) {
gap = Math.abs(start - time);
if (time >= start && time < end) {
// start the range
firstStart = start;
lastEnd = end;
} else if (gap <= toler) {
// start the range even though the buffer does not contain time 0
firstStart = start;
lastEnd = end;
}
} else {
gap = start - lastEnd;
if (gap <= toler) {
// the discontinuity is smaller than the tolerance, combine the ranges
lastEnd = end;
} else {
break;
}
}
}
if (firstStart !== null) {
return {
start: firstStart,
end: lastEnd
};
}
}
return null;
}
function getBufferLength(time, tolerance) {
let range,
length;
// Consider gap/discontinuity limit as tolerance
if (settings.get().streaming.gaps.jumpGaps) {
tolerance = settings.get().streaming.gaps.smallGapLimit;
}
range = getRangeAt(time, tolerance);
if (range === null) {
length = 0;
} else {
length = range.end - time;
}
return length;
}
function _updateBufferLevel() {
if (playbackController) {
let referenceTime = playbackController.getTime() || 0;
// In case we are prebuffering we dont have a current time yet
if (isPrebuffering) {
referenceTime = !isNaN(seekTarget) ? seekTarget : 0;
}
const tolerance = settings.get().streaming.gaps.jumpGaps && !isNaN(settings.get().streaming.gaps.smallGapLimit) ? settings.get().streaming.gaps.smallGapLimit : NaN;
bufferLevel = Math.max(getBufferLength(referenceTime, tolerance), 0);
_triggerEvent(Events.BUFFER_LEVEL_UPDATED, { mediaType: type, bufferLevel: bufferLevel });
checkIfSufficientBuffer();
}
}
function _checkIfBufferingCompleted() {
const isLastIdxAppended = maxAppendedIndex >= maximumIndex - 1; // Handles 0 and non 0 based request index
// To avoid rounding error when comparing, the stream time and buffer level only must be within 5 decimal places
const periodBuffered = playbackController.getTimeToStreamEnd(streamInfo) - bufferLevel < 0.00001;
if ((isLastIdxAppended || periodBuffered) && !isBufferingCompleted) {
setIsBufferingCompleted(true);
logger.debug(`checkIfBufferingCompleted trigger BUFFERING_COMPLETED for stream id ${streamInfo.id} and type ${type}`);
}
}
function checkIfSufficientBuffer() {
// No need to check buffer if type is not audio or video (for example if several errors occur during text parsing, so that the buffer cannot be filled, no error must occur on video playback)
if (type !== Constants.AUDIO && type !== Constants.VIDEO) return;
// When the player is working in low latency mode, the buffer is often below STALL_THRESHOLD.
// So, when in low latency mode, change dash.js behavior so it notifies a stall just when
// buffer reach 0 seconds
if (((!playbackController.getLowLatencyModeEnabled() && bufferLevel < settings.get().streaming.buffer.stallThreshold) || bufferLevel === 0) && !isBufferingCompleted) {
_notifyBufferStateChanged(MetricsConstants.BUFFER_EMPTY);
} else {
if (isBufferingCompleted || bufferLevel >= settings.get().streaming.buffer.stallThreshold || (playbackController.getLowLatencyModeEnabled() && bufferLevel > 0)) {
_notifyBufferStateChanged(MetricsConstants.BUFFER_LOADED);
}
}
}
function _notifyBufferStateChanged(state) {
if (bufferState === state ||
(state === MetricsConstants.BUFFER_EMPTY && playbackController.getTime() === 0) || // Don't trigger BUFFER_EMPTY if it's initial loading
(type === Constants.TEXT && !textController.isTextEnabled())) {
return;
}
bufferState = state;
_triggerEvent(Events.BUFFER_LEVEL_STATE_CHANGED, { state: state });
_triggerEvent(state === MetricsConstants.BUFFER_LOADED ? Events.BUFFER_LOADED : Events.BUFFER_EMPTY);
logger.debug(state === MetricsConstants.BUFFER_LOADED ? 'Got enough buffer to start' : 'Waiting for more buffer before starting playback');
}
/* prune buffer on our own in background to avoid browsers pruning buffer silently */
function pruneBuffer() {
if (!sourceBufferSink || type === Constants.TEXT) {
return;
}
if (!isBufferingCompleted) {
clearBuffers(getClearRanges());
}
}
function getClearRanges() {
const clearRanges = [];
const ranges = sourceBufferSink.getAllBufferRanges();
if (!ranges || ranges.length === 0) {
return clearRanges;
}
const currentTime = playbackController.getTime();
let startRangeToKeep = Math.max(0, currentTime - settings.get().streaming.buffer.bufferToKeep);
const currentTimeRequest = fragmentModel.getRequests({
state: FragmentModel.FRAGMENT_MODEL_EXECUTED,
time: currentTime,
threshold: BUFFER_RANGE_CALCULATION_THRESHOLD
})[0];
// Ensure we keep full range of current fragment
if (currentTimeRequest) {
startRangeToKeep = Math.min(currentTimeRequest.startTime, startRangeToKeep);
} else if (currentTime === 0 && playbackController.getIsDynamic()) {
// Don't prune before the live stream starts, it messes with low latency
return [];
}
if (ranges.start(0) <= startRangeToKeep) {
const behindRange = {
start: 0,
end: startRangeToKeep
};
for (let i = 0; i < ranges.length && ranges.end(i) <= startRangeToKeep; i++) {
behindRange.end = ranges.end(i);
}
if (behindRange.start < behindRange.end) {
clearRanges.push(behindRange);
}
}
return clearRanges;
}
function clearBuffers(ranges) {
return new Promise((resolve, reject) => {
if (!ranges || !sourceBufferSink || ranges.length === 0) {
resolve();
return;
}
const promises = [];
ranges.forEach((range) => {
promises.push(_addClearRangeWithPromise(range));
});
if (!isPruningInProgress) {
clearNextRange();
}
Promise.all(promises)
.then(() => {
resolve();
})
.catch((e) => {
reject(e);
});
});
}
function _addClearRangeWithPromise(range) {
return new Promise((resolve, reject) => {
range.resolve = resolve;
range.reject = reject;
pendingPruningRanges.push(range);
});
}
function clearNextRange() {
try {
// If there's nothing to prune reset state
if (pendingPruningRanges.length === 0 || !sourceBufferSink) {
logger.debug('Nothing to prune, halt pruning');
pendingPruningRanges = [];
isPruningInProgress = false;
return;
}
const sourceBuffer = sourceBufferSink.getBuffer();
// If there's nothing buffered any pruning is invalid, so reset our state
if (!sourceBuffer || !sourceBuffer.buffered || sourceBuffer.buffered.length === 0) {
logger.debug('SourceBuffer is empty (or does not exist), halt pruning');
pendingPruningRanges = [];
isPruningInProgress = false;
return;
}
const range = pendingPruningRanges.shift();
logger.debug(`${type}: Removing buffer from: ${range.start} to ${range.end}`);
isPruningInProgress = true;
// If removing buffer ahead current playback position, update maxAppendedIndex
const currentTime = playbackController.getTime();
if (currentTime < range.end) {
setIsBufferingCompleted(false);
}
sourceBufferSink.remove(range)
.then((e) => {
_onRemoved(e);
})
.catch((e) => {
_onRemoved(e);
});
} catch (e) {
isPruningInProgress = false;
}
}
function _onRemoved(e) {
logger.debug('onRemoved buffer from:', e.from, 'to', e.to);
if (!sourceBufferSink) {
return;
}
const ranges = sourceBufferSink.getAllBufferRanges();
_showBufferRanges(ranges);
if (pendingPruningRanges.length === 0) {
isPruningInProgress = false;
_updateBufferLevel();
}
if (e.unintended) {
logger.warn('Detected unintended removal from:', e.from, 'to', e.to, 'setting streamprocessor time to', e.from);
_triggerEvent(Events.SEEK_TARGET, { time: e.from });
}
if (isPruningInProgress) {
clearNextRange();
} else {
if (!replacingBuffer) {
_updateBufferLevel();
} else {
replacingBuffer = false;
}
_triggerEvent(Events.BUFFER_CLEARED, {
from: e.from,
to: e.to,
unintended: e.unintended,
hasEnoughSpaceToAppend: hasEnoughSpaceToAppend(),
quotaExceeded: isQuotaExceeded
});
}
}
function updateBufferTimestampOffset(representationInfo) {
return new Promise((resolve) => {
if (!representationInfo || representationInfo.MSETimeOffset === undefined || !sourceBufferSink || !sourceBufferSink.updateTimestampOffset) {
resolve();
return;
}
// Each track can have its own @presentationTimeOffset, so we should set the offset
// if it has changed after switching the quality or updating an mpd
sourceBufferSink.updateTimestampOffset(representationInfo.MSETimeOffset)
.then(() => {
resolve();
})
.catch(() => {
resolve();
});
});
}
function updateAppendWindow() {
if (sourceBufferSink && !isBufferingCompleted) {
return sourceBufferSink.updateAppendWindow(streamInfo);
}
return Promise.resolve();
}
function segmentRequestingCompleted(segmentIndex) {
if (!isNaN(segmentIndex)) {
maximumIndex = segmentIndex;
_checkIfBufferingCompleted();
}
}
function _onWallclockTimeUpdated() {
wallclockTicked++;
const secondsElapsed = (wallclockTicked * (settings.get().streaming.wallclockTimeUpdateInterval / 1000));
if ((secondsElapsed >= settings.get().streaming.buffer.bufferPruningInterval)) {
wallclockTicked = 0;
pruneBuffer();
}
}
function _onPlaybackRateChanged() {
checkIfSufficientBuffer();
}
function getBuffer() {
return sourceBufferSink;
}
function getBufferLevel() {
return bufferLevel;
}
function getMediaSource() {
return mediaSource;
}
function getIsBufferingCompleted() {
return isBufferingCompleted;
}
function setIsBufferingCompleted(value) {
isBufferingCompleted = value;
if (isBufferingCompleted) {
_triggerEvent(Events.BUFFERING_COMPLETED);
} else {
maximumIndex = Number.POSITIVE_INFINITY;
}
}
function getIsPruningInProgress() {
return isPruningInProgress;
}
function getTotalBufferedTime() {
try {
const ranges = sourceBufferSink.getAllBufferRanges();
let totalBufferedTime = 0;
let ln,
i;
if (!ranges) return totalBufferedTime;
for (i = 0, ln = ranges.length; i < ln; i++) {
totalBufferedTime += ranges.end(i) - ranges.start(i);
}
return totalBufferedTime;
} catch (e) {
return 0;
}
}
/**
* This function returns the maximum time for which the buffer is continuous starting from a target time.
* As soon as there is a gap we return the time before the gap starts
* @param {number} targetTime
*/
function getContinuousBufferTimeForTargetTime(targetTime) {
try {
let adjustedTime = targetTime;
const ranges = sourceBufferSink.getAllBufferRanges();
if (!ranges || ranges.length === 0) {
return NaN;
}
let i = 0;
while (adjustedTime === targetTime && i < ranges.length) {
const start = ranges.start(i);
const end = ranges.end(i);
if (adjustedTime >= start && adjustedTime <= end) {
adjustedTime = end;
}
i += 1;
}
return adjustedTime === targetTime ? NaN : adjustedTime;
} catch (e) {
}
}
function hasEnoughSpaceToAppend() {
const totalBufferedTime = getTotalBufferedTime();
return (isNaN(totalBufferedTime) || totalBufferedTime < criticalBufferLevel);
}
function setSeekTarget(value) {
seekTarget = value;
}
function _triggerEvent(eventType, data) {
let payload = data || {};
eventBus.trigger(eventType, payload, { streamId: streamInfo.id, mediaType: type });
}
function resetInitialSettings(errored, keepBuffers) {
criticalBufferLevel = Number.POSITIVE_INFINITY;
bufferState = undefined;
maximumIndex = Number.POSITIVE_INFINITY;
maxAppendedIndex = 0;
appendedBytesInfo = null;
isBufferingCompleted = false;
isPruningInProgress = false;
isQuotaExceeded = false;
bufferLevel = 0;
wallclockTicked = 0;
pendingPruningRanges = [];
seekTarget = NaN;
isPrebuffering = false;
if (sourceBufferSink) {
let tmpSourceBufferSinkToReset = sourceBufferSink;
sourceBufferSink = null;
if (!errored && !keepBuffers) {
tmpSourceBufferSinkToReset.abort()
.then(() => {
tmpSourceBufferSinkToReset.reset(keepBuffers);
tmpSourceBufferSinkToReset = null;
});
}
}
replacingBuffer = false;
}
function reset(errored, keepBuffers) {
eventBus.off(Events.INIT_FRAGMENT_LOADED, _onInitFragmentLoaded, this);
eventBus.off(Events.MEDIA_FRAGMENT_LOADED, _onMediaFragmentLoaded, this);
eventBus.off(Events.WALLCLOCK_TIME_UPDATED, _onWallclockTimeUpdated, this);
eventBus.off(MediaPlayerEvents.PLAYBACK_PLAYING, _onPlaybackPlaying, this);
eventBus.off(MediaPlayerEvents.PLAYBACK_PROGRESS, _onPlaybackProgression, this);
eventBus.off(MediaPlayerEvents.PLAYBACK_TIME_UPDATED, _onPlaybackProgression, this);
eventBus.off(MediaPlayerEvents.PLAYBACK_RATE_CHANGED, _onPlaybackRateChanged, this);
eventBus.off(MediaPlayerEvents.PLAYBACK_STALLED, _onPlaybackStalled, this);
resetInitialSettings(errored, keepBuffers);
}
instance = {
initialize,
getStreamId,
getType,
getBufferControllerType,
createBufferSink,
dischargePreBuffer,
getBuffer,
getBufferLevel,
getRangeAt,
hasBufferAtTime,
pruneBuffer,
setMediaSource,
getMediaSource,
appendInitSegmentFromCache,
getIsBufferingCompleted,
setIsBufferingCompleted,
getIsPruningInProgress,
reset,
prepareForPlaybackSeek,
prepareForReplacementTrackSwitch,
prepareForNonReplacementTrackSwitch,
prepareForForceReplacementQualitySwitch,
updateAppendWindow,
getAllRangesWithSafetyFactor,
getContinuousBufferTimeForTargetTime,
clearBuffers,
pruneAllSafely,
updateBufferTimestampOffset,
setSeekTarget,
segmentRequestingCompleted
};
setup();
return instance;
}
BufferController.__dashjs_factory_name = BUFFER_CONTROLLER_TYPE;
export default FactoryMaker.getClassFactory(BufferController);
</code></pre></article></section></div></div></div><div class="search-container" id="PkfLWpAbet" style="display:none"><div class="wrapper" id="iCxFxjkHbP"><button class="icon-button search-close-button" id="VjLlGakifb" aria-label="close search"><svg><use xlink:href="#close-icon"></use></svg></button><div class="search-box-c"><svg><use xlink:href="#search-icon"></use></svg> <input type="text" id="vpcKVYIppa" class="search-input" placeholder="Search..." autofocus></div><div class="search-result-c" id="fWwVHRuDuN"><span class="search-result-c-text">Type anything to view search result</span></div></div></div><div class="mobile-menu-icon-container"><button class="icon-button" id="mobile-menu" data-isopen="false" aria-label="menu"><svg><use xlink:href="#menu-icon"></use></svg></button></div><div id="mobile-sidebar" class="mobile-sidebar-container"><div class="mobile-sidebar-wrapper"><a href="/" class="sidebar-title sidebar-title-anchor">Home</a><div class="mobile-nav-links"></div><div class="mobile-sidebar-items-c"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-DashAdapter.html">DashAdapter</a></div><div class="sidebar-section-children"><a href="module-DashMetrics.html">DashMetrics</a></div><div class="sidebar-section-children"><a href="module-MediaPlayer.html">MediaPlayer</a></div><div class="sidebar-section-children"><a href="module-OfflineController.html">OfflineController</a></div><div class="sidebar-section-children"><a href="module-ProtectionController.html">ProtectionController</a></div><div class="sidebar-section-children"><a href="module-Settings.html">Settings</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="Errors.html">Errors</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html">MediaPlayerEvents</a></div><div class="sidebar-section-children"><a href="MediaPlayerModel.html">MediaPlayerModel</a></div><div class="sidebar-section-children"><a href="MetricsReportingEvents.html">MetricsReportingEvents</a></div><div class="sidebar-section-children"><a href="MssErrors.html">MssErrors</a></div><div class="sidebar-section-children"><a href="OfflineErrors.html">OfflineErrors</a></div><div class="sidebar-section-children"><a href="OfflineEvents.html">OfflineEvents</a></div><div class="sidebar-section-children"><a href="ProtectionErrors.html">ProtectionErrors</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html">ProtectionEvents</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-events"><div>Events</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:ADAPTATION_SET_REMOVED_NO_CAPABILITIES">ADAPTATION_SET_REMOVED_NO_CAPABILITIES</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:AST_IN_FUTURE">AST_IN_FUTURE</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:BASE_URLS_UPDATED">BASE_URLS_UPDATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:BUFFER_EMPTY">BUFFER_EMPTY</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:BUFFER_LEVEL_STATE_CHANGED">BUFFER_LEVEL_STATE_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:BUFFER_LEVEL_UPDATED">BUFFER_LEVEL_UPDATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:BUFFER_LOADED">BUFFER_LOADED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CAN_PLAY">CAN_PLAY</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CAN_PLAY_THROUGH">CAN_PLAY_THROUGH</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CAPTION_CONTAINER_RESIZE">CAPTION_CONTAINER_RESIZE</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CAPTION_RENDERED">CAPTION_RENDERED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CONFORMANCE_VIOLATION">CONFORMANCE_VIOLATION</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CONTENT_STEERING_REQUEST_COMPLETED">CONTENT_STEERING_REQUEST_COMPLETED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CUE_ENTER">CUE_ENTER</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:CUE_ENTER">CUE_ENTER</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:DVB_FONT_DOWNLOAD_ADDED">DVB_FONT_DOWNLOAD_ADDED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:DVB_FONT_DOWNLOAD_COMPLETE">DVB_FONT_DOWNLOAD_COMPLETE</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:DVB_FONT_DOWNLOAD_FAILED">DVB_FONT_DOWNLOAD_FAILED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:DYNAMIC_TO_STATIC">DYNAMIC_TO_STATIC</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:ERROR">ERROR</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:EVENT_MODE_ON_RECEIVE">EVENT_MODE_ON_RECEIVE</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:EVENT_MODE_ON_START">EVENT_MODE_ON_START</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:FRAGMENT_LOADING_ABANDONED">FRAGMENT_LOADING_ABANDONED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:FRAGMENT_LOADING_COMPLETED">FRAGMENT_LOADING_COMPLETED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:FRAGMENT_LOADING_PROGRESS">FRAGMENT_LOADING_PROGRESS</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:FRAGMENT_LOADING_STARTED">FRAGMENT_LOADING_STARTED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:INBAND_PRFT">INBAND_PRFT</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:LOG">LOG</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:MANIFEST_LOADED">MANIFEST_LOADED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:MANIFEST_LOADING_FINISHED">MANIFEST_LOADING_FINISHED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:MANIFEST_LOADING_STARTED">MANIFEST_LOADING_STARTED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:MANIFEST_VALIDITY_CHANGED">MANIFEST_VALIDITY_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:METRIC_ADDED">METRIC_ADDED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:METRIC_CHANGED">METRIC_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:METRIC_UPDATED">METRIC_UPDATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:METRICS_CHANGED">METRICS_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PERIOD_SWITCH_COMPLETED">PERIOD_SWITCH_COMPLETED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PERIOD_SWITCH_STARTED">PERIOD_SWITCH_STARTED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_ENDED">PLAYBACK_ENDED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_ERROR">PLAYBACK_ERROR</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_LOADED_DATA">PLAYBACK_LOADED_DATA</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_METADATA_LOADED">PLAYBACK_METADATA_LOADED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_NOT_ALLOWED">PLAYBACK_NOT_ALLOWED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_PAUSED">PLAYBACK_PAUSED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_PLAYING">PLAYBACK_PLAYING</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_PROGRESS">PLAYBACK_PROGRESS</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_RATE_CHANGED">PLAYBACK_RATE_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_SEEKED">PLAYBACK_SEEKED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_SEEKING">PLAYBACK_SEEKING</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_STALLED">PLAYBACK_STALLED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_STARTED">PLAYBACK_STARTED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_TIME_UPDATED">PLAYBACK_TIME_UPDATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_VOLUME_CHANGED">PLAYBACK_VOLUME_CHANGED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:PLAYBACK_WAITING">PLAYBACK_WAITING</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:QUALITY_CHANGE_RENDERED">QUALITY_CHANGE_RENDERED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:QUALITY_CHANGE_REQUESTED">QUALITY_CHANGE_REQUESTED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:REPRESENTATION_SWITCH">REPRESENTATION_SWITCH</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_ACTIVATED">STREAM_ACTIVATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_DEACTIVATED">STREAM_DEACTIVATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_INITIALIZED">STREAM_INITIALIZED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_INITIALIZING">STREAM_INITIALIZING</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_TEARDOWN_COMPLETE">STREAM_TEARDOWN_COMPLETE</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:STREAM_UPDATED">STREAM_UPDATED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:TEXT_TRACK_ADDED">TEXT_TRACK_ADDED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:TEXT_TRACKS_ADDED">TEXT_TRACKS_ADDED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:THROUGHPUT_MEASUREMENT_STORED">THROUGHPUT_MEASUREMENT_STORED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:TRACK_CHANGE_RENDERED">TRACK_CHANGE_RENDERED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:TTML_PARSED">TTML_PARSED</a></div><div class="sidebar-section-children"><a href="MediaPlayerEvents.html#event:TTML_TO_PARSE">TTML_TO_PARSE</a></div><div class="sidebar-section-children"><a href="MetricsReportingEvents.html#event:CMCD_DATA_GENERATED">CMCD_DATA_GENERATED</a></div><div class="sidebar-section-children"><a href="OfflineEvents.html#event:OFFLINE_RECORD_FINISHED">OFFLINE_RECORD_FINISHED</a></div><div class="sidebar-section-children"><a href="OfflineEvents.html#event:OFFLINE_RECORD_LOADEDMETADATA">OFFLINE_RECORD_LOADEDMETADATA</a></div><div class="sidebar-section-children"><a href="OfflineEvents.html#event:OFFLINE_RECORD_STARTED">OFFLINE_RECORD_STARTED</a></div><div class="sidebar-section-children"><a href="OfflineEvents.html#event:OFFLINE_RECORD_STOPPED">OFFLINE_RECORD_STOPPED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_ADDED">KEY_ADDED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_ERROR">KEY_ERROR</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_MESSAGE">KEY_MESSAGE</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_SESSION_CLOSED">KEY_SESSION_CLOSED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_SESSION_CREATED">KEY_SESSION_CREATED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_SESSION_REMOVED">KEY_SESSION_REMOVED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_STATUSES_CHANGED">KEY_STATUSES_CHANGED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_SYSTEM_ACCESS_COMPLETE">KEY_SYSTEM_ACCESS_COMPLETE</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:KEY_SYSTEM_SELECTED">KEY_SYSTEM_SELECTED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:LICENSE_REQUEST_COMPLETE">LICENSE_REQUEST_COMPLETE</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:LICENSE_REQUEST_SENDING">LICENSE_REQUEST_SENDING</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:PROTECTION_CREATED">PROTECTION_CREATED</a></div><div class="sidebar-section-children"><a href="ProtectionEvents.html#event:PROTECTION_DESTROYED">PROTECTION_DESTROYED</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#LICENSE_SERVER_MANIFEST_CONFIGURATIONS">LICENSE_SERVER_MANIFEST_CONFIGURATIONS</a></div><div class="sidebar-section-children"><a href="global.html#MediaType">MediaType</a></div></div></div><div class="mobile-navbar-actions"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#dark-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div></div></div><script type="text/javascript" src="scripts/core.min.js"></script><script src="scripts/search.min.js" defer="defer"></script><script src="scripts/third-party/fuse.js" defer="defer"></script><script type="text/javascript">var tocbotInstance=tocbot.init({tocSelector:"#eed4d2a0bfd64539bb9df78095dec881",contentSelector:".main-content",headingSelector:"h1, h2, h3",hasInnerContainers:!0,scrollContainer:".main-content",headingsOffset:130,onClick:bringLinkToView})</script></body></html>