前陣子我實作了一個基於 HTML5 video 的影片播放器,從一開始的一無所知,到最後能寫出一個相對完善的自訂播放器,這個過程讓我對 video 標籤的屬性、方法與事件有了全面的認識。以下將它們分類整理出來,方便查閱。
src :影片資源的位址 poster :影片封面,尚未播放時顯示的圖片 preload :預先載入 autoplay :自動播放 loop :迴圈播放 controls :瀏覽器自帶的控制條 width :影片寬度 height :影片高度
HTML 寫法如下:
<video id="media" src="https://www.jb51.Net/test.mp4" controls width="400px" height="400px"></video>
// audio 和 video 都可以透過 JS 取得物件,這裡以 id 取得 video 物件
Media = document.getElementById("media");
HTMLVideoElement 與 HTMLAudioElement 皆繼承自 HTMLMediaElement,因此兩者共享大量通用的屬性與方法。
Media.error; // null 表示正常 Media.error.code; // 1.使用者終止 2.網路錯誤 3.解碼錯誤 4.URL 無效 // 網路狀態 - Media.currentSrc; // 回傳當前資源的 URL - Media.src = value; // 取得或設定當前資源的 URL - Media.canPlayType(type); // 是否能播放某種格式的資源 - Media.networkState; // 0.未初始化 1.正常但未使用網路 2.正在下載 3.找不到資源 - Media.load(); // 重新載入 src 指定的資源 - Media.buffered; // 回傳已緩衝區域,TimeRanges - Media.preload; // none:不預載 metadata:預載資訊 auto:全部預載 // 準備狀態 - Media.readyState; // 1.HAVE_NOTHING 2.HAVE_METADATA 3.HAVE_CURRENT_DATA 4.HAVE_FUTURE_DATA 5.HAVE_ENOUGH_DATA - Media.seeking; // 是否正在 seeking // 回放狀態 Media.currentTime = value; // 當前播放位置,賦值可改變位置 Media.startTime; // 一般為 0,流媒體或不從 0 開始的資源則不為 0 Media.duration; // 當前資源長度,流媒體回傳無限 Media.paused; // 是否暫停 Media.defaultPlaybackRate = value; // 預設回放速度 Media.playbackRate = value; // 當前播放速度,設定後立即改變 Media.played; // 已播放的區域,TimeRanges Media.seekable; // 可 seek 的區域,TimeRanges Media.ended; // 是否結束 Media.autoPlay; // 是否自動播放 Media.loop; // 是否迴圈播放 Media.play(); // 播放 Media.pause(); // 暫停 // 影片控制 Media.controls; // 是否有預設控制條 Media.volume = value; // 音量 Media.muted = value; // 靜音
buffered、played、seekable 等屬性回傳的都是 TimeRanges 物件,用來描述某段時間區間:
TimeRanges.length; // 區域段數 TimeRanges.start(index); // 第 index 段區域的起始位置 TimeRanges.end(index); // 第 index 段區域的結束位置
事件是驅動播放器互動的核心,以下用一個小函式把常用事件都掛上監聽器,方便觀察觸發時機:
var eventTester = function (e) {
Media.addEventListener(e, function () {
console.log((new Date()).getTime(), e);
}, false);
};
eventTester("loadstart"); // 客戶端開始請求數據
eventTester("progress"); // 客戶端正請求數據
eventTester("suspend"); // 延遲下載
eventTester("abort"); // 客戶端主動終止下載(非錯誤引起)
eventTester("error"); // 請求數據時遇到錯誤
eventTester("stalled"); // 網速失速
eventTester("play"); // play() 或 autoplay 開始播放時觸發
eventTester("pause"); // pause() 觸發
eventTester("loadedmetadata"); // 成功取得資源長度
eventTester("loadeddata"); // 載入首帧數據
eventTester("waiting"); // 等待數據,並非錯誤
eventTester("playing"); // 開始回放
eventTester("canplay"); // 可以播放,但中途可能因載取而暫停
eventTester("canplaythrough"); // 可以播放,且資源已載入完畢
eventTester("seeking"); // 尋找中
eventTester("seeked"); // 尋找完畢
eventTester("timeupdate"); // 播放時間改變
eventTester("ended"); // 播放結束
eventTester("ratechange"); // 播放速率改變
eventTester("durationchange"); // 資源長度改變
eventTester("volumechange"); // 音量改變
把這些屬性、方法與事件摸熟,基本上就足以應付絕大多數客製化播放器的開發需求了。實際動手做一遍,會比單純背誦更有效果。