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 | 影片因需要緩衝下一幀而停止時觸發 |
