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