Display the duration, current time, and remaining time of the video
Last update: 2023-10-02
Topics:
Created for:
You can use Browser TVSDK to retrieve information about the media that you can display on the seek bar.
Wait for your player to be in at least the PREPARED state.
Retrieve the current playhead time using the MediaPlayer.currentTime attribute.
This attribute returns the current playhead position on the virtual timeline in milliseconds. The time is calculated relative to the resolved stream that might contain multiple instances of alternate content, such as multiple ads or ad breaks spliced into the main stream. For live/linear streams, the returned time is always in the playback window range.
MediaPlayer.currentTime
Retrieve the playback range of the stream and determine the duration.
Use the mediaPlayer.playbackRange property to get the virtual timeline time range.
To determine the duration, subtract the start from the end of the range.
This includes the duration of additional content that is inserted into the stream (ads).
For VOD, the range always begins with zero and the end value equals the sum of the main content duration and the durations of additional content that is inserted in the stream (ads).
For a linear/live asset, the range represents the playback window range, and this range changes during playback.
Use the methods available on the MediaPlayer and Browser TVSDK elements to set up the seek bar parameters.
For example, here is a possible layout to display the seek bar in HTML.
Listen for AdobePSDK.TimeChangeEvent and update the seekbar accordingly.
player.addEventListener(AdobePSDK.PSDKEventType.TIME_CHANGED, onTimeChange);
/**
* Called when the player's time changes.
* Update UI to show current time, seekbar playhead position and buffer level.
*/
function onTimeChange(event)
{
if (!seekBar.isSeeking) {
var time = event.time;
var range = player.playbackRange;
seekBar.updatePlayhead(time, range);
updateDisplayTime(time, range);
var bufferedRange = player.bufferedRange;
seekBar.updateBufferLevel(bufferedRange.end, range);
}
}
This example creates a seekbar object to update the seekbar:
/**
* Seekbar object which handles the display of the player progress,
* playhead, and buffer level.
*/
seekBar = (function () {
var playheadHalfSize = 8, // must be half width of playhead defined in CSS
containerElm = null,
playheadElm = null,
backerElm = null,
bufferElm = null,
progressElm = null,
currentPos = 0, // [0,1] relative to range
currentBuffer = 0,// [0,1] relative to range
listener = null,
isSeeking = false,
setPositionChangeListener = function (funct) {
listener = funct;
},
getSeekBarBounds = function () {
return backerElm.getBoundingClientRect();
},
onPositionChange = function (event) {
var pos = event.pageX || event.clientX;
var bounds = getSeekBarBounds();
// normalize position to seek bounds
pos -= bounds.left;
var percent = pos / (bounds.right - bounds.left);
// check bounds
if (percent > 1) percent = 1;
else if (percent < 0) percent = 0;
currentPos = percent;
setPosition(percent);
},
updatePlayhead = function (time, range) {
if (!isSeeking) {
var pos = convertTimeToRelativePosition(time, range);
setPosition(pos);
}
},
setPosition = function (percent) {
// adjust to keep playhead graphic inside container on right side
var bounds = getSeekBarBounds();
var pos = percent * (bounds.right - bounds.left);
progressElm.style.width = (pos).toString() + "px";
playheadElm.style.left = (pos-playheadHalfSize).toString() + "px";
currentPos = percent;
return percent;
},
updateBufferLevel = function (level, range) {
if (!isSeeking) {
var position = convertTimeToRelativePosition(level, range);
setBufferLevel(position);
}
},
setBufferLevel = function (percent) {
currentBuffer = percent;
var bounds = getSeekBarBounds();
var pos = percent * (bounds.right - bounds.left);
bufferElm.style.width = pos.toString() + "px";
},
resetSeekBar = function () {
setPosition(currentPos);
setBufferLevel(currentBuffer);
},
convertTimeToRelativePosition = function (time, range) {
// convert time to a percentage of the duration
var position = (time - range.begin) / range.duration;
if (position > 1) position = 1;
else if (position < 0) position = 0;
return position;
},
unattachEvents = function (e) {
this.removeEventListener('mousemove', onPositionChange);
this.removeEventListener('mouseout', unattachEvents);
this.removeEventListener('mouseup', unattachEvents);
this.addEventListener('mouseover', attachEvents);
isSeeking = false;
},
attachEvents = function (e) {
this.addEventListener('mousemove', onPositionChange);
this.addEventListener('mouseout', unattachEvents);
this.addEventListener('mouseup', unattachEvents);
isSeeking = true;
return false;
};
return {
init : function () {
containerElm = document.getElementById("seekbar");
backerElm = document.getElementById("backer");
playheadElm = document.getElementById("playhead");
bufferElm = document.getElementById("buffer");
progressElm = document.getElementById("progress");
// client seek via scrubbing
containerElm.addEventListener('mousedown', attachEvents);
// client seek via single click or 'mouseup' after scrubbing
containerElm.addEventListener('click', function (e) {
if (listener !== null && !player.areControlsDisabledInAd()) {
onPositionChange(e);
// callback to notify of desired seek position
listener.call(this, currentPos);
}
});
// end client seek via scrubbing
document.addEventListener('mouseup', function (e) {
containerElm.removeEventListener('mouseover', attachEvents);
});
},
/**
* Is the playhead currently being scrubbed.
*/
isSeeking : isSeeking,
/**
* Change the position of the playhead.
* @param time - time in seconds to position playhead
* @param range - current playback range
*/
updatePlayhead : updatePlayhead,
/**
* Change the position of the buffer range.
* @param time - time in seconds to position head of buffer
* @param range - current playback range
*/
updateBufferLevel : updateBufferLevel,
/**
* Set listener which is called when the playhead position changes
* by the user event. Listener is not called when playhead position
* changes via updatePlayhead function.
* @param listener - callback function, passed single position argument
* representing the playhead position in the range [0,1].
*/
setPositionChangeListener : setPositionChangeListener,
/**
* Readjust position levels if seekbar is resized.
* Should be called every time the video window changes size.
*/
readjustSeekBar : resetSeekBar
};
})();
