做過自製播放器的人都知道,進度條、總時長這些看似理所當然的資訊,其實都要靠 video 元素的事件才有辦法取得。HTML5 把多媒體播放的整個生命週期都包在一組標準事件裡,只要挑對時機掛上監聽,剩下的就交給瀏覽器。
video 元素載入媒體後,並不會馬上知道整支片有多長,必須等 metadata(中繼資料)解析完成。這個時機對應的事件就是 onloadedmetadata,此時 duration 屬性才會帶回可信的秒數。
video.onloadedmetadata = function () {
var vLength = video.duration;
console.log(vLength);
}
實務上建議在這裡順手把進度條的總刻度、時間顯示一起初始化,避免使用者看到「00:00 / 00:00」的尷尬畫面。若來源是串流(live stream),duration 可能回傳 Infinity,這點要另外判斷。
當播放位置改變時,瀏覽器會觸發 ontimeupdate,此時可以讀取 currentTime 取得目前秒數。要注意 currentTime 是浮點數,精度可以細到小數點後十幾位,因此更新畫面時通常要自行四捨五入或格式化。
video.ontimeupdate = function () {
var vTime = video.currentTime;
console.log(vTime);
};
由於這個事件的觸發頻率大約是每秒四次,並不是每一幀都觸發,所以拿來更新進度條與時間文字綽綽有餘,又不會造成不必要的效能負擔。反過來,若要寫入後端播放記錄,記得加上節流(throttle),不要每觸發一次就打一次 API。
實作播放器時,通常不會只用這兩個事件。常見的搭配有:onplay/onpause 切換播放狀態圖示、onended 處理播放完畢、onvolumechange 同步音量 UI、onwaiting 顯示轉圈動畫。把這些事件串起來,一個不依賴任何外掛的 HTML5 播放器雛形就完成了。