HTML 音頻/視頻 DOM 參考手冊

HTML 音頻/視頻 DOM 參考手冊

HTML5 DOM 爲 <audio> 和 <video> 元素提供了方法、屬性和事件。

這些方法、屬性和事件容許您使用 JavaScript 來操做 <audio> 和 <video> 元素。

---

HTML 音頻/視頻 方法

方法	描述
addTextTrack()	向音頻/視頻添加新的文本軌道。
canPlayType()	檢測瀏覽器是否能播放指定的音頻/視頻類型。
load()	從新加載音頻/視頻元素。
play()	開始播放音頻/視頻。
pause()	暫停當前播放的音頻/視頻。

HTML 音頻/視頻屬性

屬性	描述
audioTracks	返回表示可用音頻軌道的 AudioTrackList 對象。
autoplay	設置或返回是否在加載完成後隨即播放音頻/視頻。
buffered	返回表示音頻/視頻已緩衝部分的 TimeRanges 對象。
controller	返回表示音頻/視頻當前媒體控制器的 MediaController 對象。
controls	設置或返回音頻/視頻是否顯示控件（好比播放/暫停等）。
crossOrigin	設置或返回音頻/視頻的 CORS 設置。
currentSrc	返回當前音頻/視頻的 URL。
currentTime	設置或返回音頻/視頻中的當前播放位置（以秒計）。
defaultMuted	設置或返回音頻/視頻默認是否靜音。

defaultPlaybackRate	設置或返回音頻/視頻的默認播放速度。
duration	返回當前音頻/視頻的長度（以秒計）。
ended	返回音頻/視頻的播放是否已結束。
error	返回表示音頻/視頻錯誤狀態的 MediaError 對象。
loop	設置或返回音頻/視頻是否應在結束時從新播放。
mediaGroup	設置或返回音頻/視頻所屬的組合（用於鏈接多個音頻/視頻元素）。
muted	設置或返回音頻/視頻是否靜音。
networkState	返回音頻/視頻的當前網絡狀態。
paused	設置或返回音頻/視頻是否暫停。
playbackRate	設置或返回音頻/視頻播放的速度。

played	返回表示音頻/視頻已播放部分的 TimeRanges 對象。
preload	設置或返回音頻/視頻是否應該在頁面加載後進行加載。
readyState	返回音頻/視頻當前的就緒狀態。
seekable	返回表示音頻/視頻可尋址部分的 TimeRanges 對象。
seeking	返回用戶是否正在音頻/視頻中進行查找。
src	設置或返回音頻/視頻元素的當前來源。
startDate	返回表示當前時間偏移的 Date 對象。
textTracks	返回表示可用文本軌道的 TextTrackList 對象。
videoTracks	返回表示可用視頻軌道的 VideoTrackList 對象。
volume	設置或返回音頻/視頻的音量。

HTML 音頻/視頻事件

abort	當音頻/視頻的加載已放棄時觸發。
canplay	當瀏覽器能夠開始播放音頻/視頻時觸發。
canplaythrough	當瀏覽器可在不因緩衝而停頓的狀況下進行播放時觸發。
durationchange	當音頻/視頻的時長已更改時觸發。
emptied	當目前的播放列表爲空時觸發。
ended	當目前的播放列表已結束時觸發。
error	當在音頻/視頻加載期間發生錯誤時觸發。
loadeddata	當瀏覽器已加載音頻/視頻的當前幀時觸發。
loadedmetadata	當瀏覽器已加載音頻/視頻的元數據時觸發。
loadstart	當瀏覽器開始查找音頻/視頻時觸發。

pause	當音頻/視頻已暫停時觸發。
play	當音頻/視頻已開始或再也不暫停時觸發。
playing	當音頻/視頻在因緩衝而暫停或中止後已就緒時觸發。
progress	當瀏覽器正在下載音頻/視頻時觸發。
ratechange	當音頻/視頻的播放速度已更改時觸發。
seeked	當用戶已移動/跳躍到音頻/視頻中的新位置時觸發。
seeking	當用戶開始移動/跳躍到音頻/視頻中的新位置時觸發。
stalled	當瀏覽器嘗試獲取媒體數據，但數據不可用時觸發。
suspend	當瀏覽器刻意不獲取媒體數據時觸發。
timeupdate	當目前的播放位置已更改時觸發。

volumechange	當音量已更改時觸發。
waiting	當視頻因爲須要緩衝下一幀而中止時觸發。