DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5教程
HTML5 Video 標籤的屬性、方法與事件完整對照
編輯:HTML5教程     

前陣子寫了一個以 HTML5 video 為基礎的播放器。從完全不了解這個標籤,到能做出功能完整的自訂介面,過程中最花時間的就是搞清楚哪些屬性可讀、哪些可寫、哪些事件該監聽。以下分類整理出來,當成速查表用。

標籤屬性

 <video id="media" src="https://www.jb51.net/test.mp4"
       controls width="400" height="400"></video>


  • src:影片來源。
  • poster:封面圖,未播放時顯示。
  • preload:預載入策略。
  • autoplay:自動播放。
  • loop:迴圈播放。
  • controls:顯示瀏覽器預設控制列。
  • width / height:播放器尺寸。

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;    // 靜音

TimeRanges 物件

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);

各事件的意義:


  • loadstart:用戶端開始請求資料。
  • progress:正在下載資料。
  • suspend:下載被延後。
  • abort:用戶端主動中止下載(非錯誤導致)。
  • error:請求資料時發生錯誤。
  • stalled:網路速度異常下降。
  • play / pause:呼叫 play()、autoplay 觸發時/呼叫 pause() 時。
  • loadedmetadata:已取得資源長度等中繼資料。
  • loadeddata:目前幀資料已載入。
  • waiting:等待資料,並非錯誤。
  • playing:開始實際回放。
  • canplay:可以播放,但中途可能因需載入而暫停。
  • canplaythrough:可以播放,且估計能完整播完不需緩衝。
  • seeking / seeked:跳轉開始/結束。
  • timeupdate:播放進度改變(觸發頻率約每 250ms 一次)。
  • ended:播放結束。
  • ratechange:播放速率改變。
  • durationchange:資源長度改變。
  • volumechange:音量改變。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved