前陣子寫了一個以 HTML5 video 為基礎的播放器。從完全不了解這個標籤,到能做出功能完整的自訂介面,過程中最花時間的就是搞清楚哪些屬性可讀、哪些可寫、哪些事件該監聽。以下分類整理出來,當成速查表用。
<video id="media" src="https://www.jb51.net/test.mp4"
controls width="400" height="400"></video>
audio 與 video 都能透過 id 取得物件:
Media = document.getElementById("media");
HTMLVideoElement 與 HTMLAudioElement 都繼承自 HTMLMediaElement,因此絕大多數 API 是共通的。
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; // 是否正在跳轉
Media.currentTime = value; // 目前播放位置,可寫入以跳轉
Media.startTime; // 一般為 0;串流或非從 0 開始的資源則不然
Media.duration; // 總長度(秒),串流回傳 Infinity
Media.paused; // 是否暫停
Media.defaultPlaybackRate = value; // 預設播放速率
Media.playbackRate = value; // 目前播放速率,設定後立即生效
Media.played; // 已播放區段(TimeRanges)
Media.seekable; // 可跳轉區段(TimeRanges)
Media.ended; // 是否播放結束
Media.autoPlay; // 是否自動播放
Media.loop; // 是否迴圈
Media.play(); // 播放
Media.pause(); // 暫停
Media.controls; // 是否顯示預設控制列
Media.volume = value; // 音量,範圍 0~1
Media.muted = value; // 靜音
buffered、played、seekable 都回傳這個物件,用來描述「哪幾段時間範圍內的資料可用」。
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);
}
["loadstart", "progress", "suspend", "abort", "error", "stalled",
"play", "pause", "loadedmetadata", "loadeddata", "waiting", "playing",
"canplay", "canplaythrough", "seeking", "seeked", "timeupdate",
"ended", "ratechange", "durationchange", "volumechange"
].forEach(eventTester);
各事件的意義: