自製播放器一定會遇到兩個基本問題:這支片子多長?現在播到哪?HTML5 的 <video> 已經內建了對應事件,不需要任何外掛。本文示範 onloadedmetadata 與 ontimeupdate 的用法。
關鍵在於「時機」。video.duration 在 video 元素剛建立時是 NaN,必須等瀏覽器讀完成故排除檔(metadata)才有值。這個時機點就是 loadedmetadata 事件。
video.onloadedmetadata = function () {
var vLength = video.duration;
console.log(vLength);
};
若要顯示成人類看得懂的 mm:ss,可以自己格式化:
function formatTime(seconds) {
if (!isFinite(seconds)) { return '--:--'; }
var m = Math.floor(seconds / 60);
var s = Math.floor(seconds % 60);
return (m < 10 ? '0' : '') + m + ':' + (s < 10 ? '0' : '') + s;
}
video.onloadedmetadata = function () {
document.getElementById('total').textContent = formatTime(video.duration);
};
播放過程中,每當 currentTime 屬性改變就會觸發 timeupdate 事件。currentTime 是個浮點數,精度可達小數後十幾位,實務上取整數秒即可。
video.ontimeupdate = function () {
var vTime = video.currentTime;
console.log(vTime);
};
有了總長與目前時間,進度條就是比例問題:
video.ontimeupdate = function () {
var duration = video.duration;
var current = video.currentTime;
var percent = duration ? (current / duration) * 100 : 0;
document.getElementById('bar').style.width = percent + '%';
document.getElementById('time').textContent =
formatTime(current) + ' / ' + formatTime(duration);
};
onloadedmetadata:時長、解析度等資訊就緒。oncanplay:已有足夠資料可以開始播放,適合在這裡啟用播放按鈕。onplay / onpause:播放與暫停,用來切換按鈕圖示。onended:播放結束,可用來自動播放下一集。onvolumechange:音量變化,同步音量圖示。onseeking / onseeked:使用者拖動進度條的開始與結束,拖曳期間可暫停更新進度條避免抖動。onwaiting / onstalled:需要等待資料,適合顯示轉圈動畫。timeupdate 的觸發頻率約為每秒 4 到 66 次,視瀏覽器而定,並不是固定值。若你的進度條動畫吃重,建議搭配 requestAnimationFrame 做節流,把畫面更新與事件觸發分離;反過來說,如果只是更新文字,直接用事件就好,不必多一層。
另外要注意 duration 在串流(live stream)情境下可能是 Infinity,格式化前務必先擋掉,否則畫面上會出現一串 NaN。