HTML 音訊/影片 DOM 參考
HTML 音訊和影片 DOM 參考
HTML5 DOM 為 <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 物件,表示音訊/影片的錯誤狀態 |
迴圈 | 設定或返回音訊/影片播放完畢後是否應重新開始 |
mediaGroup | 設定或返回音訊/影片所屬的分組(用於連結多個音訊/影片元素) |
muted | 設定或返回音訊/影片是否已靜音 |
networkState | 返回音訊/影片的當前網路狀態 |
paused | 返回音訊/影片是否已暫停 |
playbackRate | 設定或返回音訊/影片的播放速度 |
played | 返回一個 TimeRanges 物件,表示音訊/影片已播放的部分 |
preload | 設定或返回頁面載入時是否應載入音訊/影片 |
readyState | 返回音訊/影片的當前就緒狀態 |
seekable | 返回一個 TimeRanges 物件,表示音訊/影片的可搜尋部分 |
seeking | 返回使用者當前是否正在音訊/影片中進行跳轉 |
src | 設定或返回音訊/影片元素的當前源 |
startDate | 返回一個 Date 物件,表示當前時間偏移量 |
textTracks | 返回一個 TextTrackList 物件,表示可用的文字軌道 |
videoTracks | 已棄用。請勿使用。 |
volume | 設定或返回音訊/影片的音量 |
HTML 音訊/影片事件
事件 | 描述 |
---|---|
abort | 載入音訊/影片被中止時觸發 |
canplay | 瀏覽器可以開始播放音訊/影片時觸發 |
canplaythrough | 瀏覽器無需停止緩衝即可完整播放音訊/影片時觸發 |
durationchange | 音訊/影片時長髮生變化時觸發 |
emptied | 當前播放列表為空時觸發 |
ended | 當前播放列表結束時觸發 |
error | 載入音訊/影片時發生錯誤時觸發 |
loadeddata | 瀏覽器已載入音訊/影片當前幀時觸發 |
loadedmetadata | 瀏覽器已載入音訊/影片的元資料時觸發 |
loadstart | 瀏覽器開始查詢音訊/影片時觸發 |
pause | 音訊/影片已暫停時觸發 |
play | 音訊/影片已開始播放或不再暫停時觸發 |
playing | 音訊/影片在暫停或停止緩衝後開始播放時觸發 |
progress | 瀏覽器正在下載音訊/影片時觸發 |
ratechange | 音訊/影片的播放速度發生變化時觸發 |
seeked | 使用者完成在音訊/影片中移動/跳播到新位置時觸發 |
seeking | 使用者開始在音訊/影片中移動/跳播到新位置時觸發 |
stalled | 瀏覽器正在嘗試獲取媒體資料,但資料不可用時觸發 |
suspend | 瀏覽器有意不獲取媒體資料時觸發 |
timeupdate | 當前播放位置發生變化時觸發 |
volumechange | 音量發生變化時觸發 |
waiting | 影片因需要緩衝下一幀而停止時觸發 |