HTML 音頻/視頻 DOM 參考手冊
HTML5 DOM 為 <audio> 和 <video> 元素提供了方法、屬性和事件。
這些方法、屬性和事件允許您使用 JavaScript 來操作 <audio> 和 <video> 元素。
HTML 音頻/視頻 方法
方法 | 描述 |
---|
addTextTrack() | 向音頻/視頻添加新的文本軌道。 |
canPlayType() | 檢測瀏覽器是否能播放指定的音頻/視頻類型。 |
load() | 重新加載音頻/視頻元素。 |
play() | 開始播放音頻/視頻。 |
pause() | 暫停當(dāng)前播放的音頻/視頻。 |
HTML 音頻/視頻屬性
屬性 | 描述 |
---|
audioTracks | 返回表示可用音頻軌道的 AudioTrackList 對象。 |
autoplay | 設(shè)置或返回是否在加載完成后隨即播放音頻/視頻。 |
buffered | 返回表示音頻/視頻已緩沖部分的 TimeRanges 對象。 |
controller | 返回表示音頻/視頻當(dāng)前媒體控制器的 MediaController 對象。 |
controls | 設(shè)置或返回音頻/視頻是否顯示控件(比如播放/暫停等)。 |
crossOrigin | 設(shè)置或返回音頻/視頻的 CORS 設(shè)置。 |
currentSrc | 返回當(dāng)前音頻/視頻的 URL。 |
currentTime | 設(shè)置或返回音頻/視頻中的當(dāng)前播放位置(以秒計)。 |
defaultMuted | 設(shè)置或返回音頻/視頻默認是否靜音。 |
defaultPlaybackRate | 設(shè)置或返回音頻/視頻的默認播放速度。 |
duration | 返回當(dāng)前音頻/視頻的長度(以秒計)。 |
ended | 返回音頻/視頻的播放是否已結(jié)束。 |
error | 返回表示音頻/視頻錯誤狀態(tài)的 MediaError 對象。 |
loop | 設(shè)置或返回音頻/視頻是否應(yīng)在結(jié)束時重新播放。 |
mediaGroup | 設(shè)置或返回音頻/視頻所屬的組合(用于連接多個音頻/視頻元素)。 |
muted | 設(shè)置或返回音頻/視頻是否靜音。 |
networkState | 返回音頻/視頻的當(dāng)前網(wǎng)絡(luò)狀態(tài)。 |
paused | 設(shè)置或返回音頻/視頻是否暫停。 |
playbackRate | 設(shè)置或返回音頻/視頻播放的速度。 |
played | 返回表示音頻/視頻已播放部分的 TimeRanges 對象。 |
preload | 設(shè)置或返回音頻/視頻是否應(yīng)該在頁面加載后進行加載。 |
readyState | 返回音頻/視頻當(dāng)前的就緒狀態(tài)。 |
seekable | 返回表示音頻/視頻可尋址部分的 TimeRanges 對象。 |
seeking | 返回用戶是否正在音頻/視頻中進行查找。 |
src | 設(shè)置或返回音頻/視頻元素的當(dāng)前來源。 |
startDate | 返回表示當(dāng)前時間偏移的 Date 對象。 |
textTracks | 返回表示可用文本軌道的 TextTrackList 對象。 |
videoTracks | 返回表示可用視頻軌道的 VideoTrackList 對象。 |
volume | 設(shè)置或返回音頻/視頻的音量。 |
HTML 音頻/視頻事件
事件 | 描述 |
---|
abort | 當(dāng)音頻/視頻的加載已放棄時觸發(fā)。 |
canplay | 當(dāng)瀏覽器可以開始播放音頻/視頻時觸發(fā)。 |
canplaythrough | 當(dāng)瀏覽器可在不因緩沖而停頓的情況下進行播放時觸發(fā)。 |
durationchange | 當(dāng)音頻/視頻的時長已更改時觸發(fā)。 |
emptied | 當(dāng)目前的播放列表為空時觸發(fā)。 |
ended | 當(dāng)目前的播放列表已結(jié)束時觸發(fā)。 |
error | 當(dāng)在音頻/視頻加載期間發(fā)生錯誤時觸發(fā)。 |
loadeddata | 當(dāng)瀏覽器已加載音頻/視頻的當(dāng)前幀時觸發(fā)。 |
loadedmetadata | 當(dāng)瀏覽器已加載音頻/視頻的元數(shù)據(jù)時觸發(fā)。 |
loadstart | 當(dāng)瀏覽器開始查找音頻/視頻時觸發(fā)。 |
pause | 當(dāng)音頻/視頻已暫停時觸發(fā)。 |
play | 當(dāng)音頻/視頻已開始或不再暫停時觸發(fā)。 |
playing | 當(dāng)音頻/視頻在因緩沖而暫?;蛲V购笠丫途w時觸發(fā)。 |
progress | 當(dāng)瀏覽器正在下載音頻/視頻時觸發(fā)。 |
ratechange | 當(dāng)音頻/視頻的播放速度已更改時觸發(fā)。 |
seeked | 當(dāng)用戶已移動/跳躍到音頻/視頻中的新位置時觸發(fā)。 |
seeking | 當(dāng)用戶開始移動/跳躍到音頻/視頻中的新位置時觸發(fā)。 |
stalled | 當(dāng)瀏覽器嘗試獲取媒體數(shù)據(jù),但數(shù)據(jù)不可用時觸發(fā)。 |
suspend | 當(dāng)瀏覽器刻意不獲取媒體數(shù)據(jù)時觸發(fā)。 |
timeupdate | 當(dāng)目前的播放位置已更改時觸發(fā)。 |
volumechange | 當(dāng)音量已更改時觸發(fā)。 |
waiting | 當(dāng)視頻由于需要緩沖下一幀而停止時觸發(fā)。 |