Buffer Events

These API calls are used to update clients with the percentage of a file that is buffered into the player.

πŸ“˜

This only applies to VOD media. Live streaming media (HLS/DASH) does not expose this behavior.



.on('bufferChange')

Fires when the currently playing item loads additional data into its buffer

{
    "bufferPercent": 2.7706319444444443,
    "position": 7.90229,
    "duration": 648,
    "currentTime": 7.90229,
    "seekRange": {
        "start": 0,
        "end": 648
    },
    "absolutePosition": null,
    "type": "bufferChange"
}
Property Description
absolutePosition number | null Viewer's absolute position for a media file, which is the sum of the video's current time and the stream's startDateTime value (in date format)
bufferPercent number Percentage between 0 and 100 of the current media that is buffered
currentTime 8.19.0+ Position of the stream before the player seeks in seconds
duration 8.19.0+ number Current duration of the media in seconds
position number Current position of the media file in seconds
seekRange object Time range representing how much video is available for seeking in DVR streams or for buffering in live streams

See: seekRange
type Category of player event

This is always bufferChange for this event.

seekRange

Property Description
end number End time of the range relative to the currentTime of the stream in seconds
start number Start time of the range relative to the currentTime of the stream in seconds