HTML 5 視頻/音頻參考手冊 · W3School HTML 參考手冊

# HTML 5 視頻/音頻參考手冊 ## HTML5 視頻和音頻的 DOM 參考手冊 HTML5 DOM 為 <audio> 和 <video> 元素提供了方法、屬性和事件。這些方法、屬性和事件允許您使用 JavaScript 來操作 <audio> 和 <video> 元素。 ## HTML5 Audio/Video 方法 | 方法 | 描述 | | --- | --- | | [addTextTrack()](/tags/av_met_addtexttrack.asp "HTML5 Audio/Video DOM addTextTrack() 方法") | 向音頻/視頻添加新的文本軌道 | | [canPlayType()](/tags/av_met_canplaytype.asp "HTML5 Audio/Video DOM canPlayType() 方法") | 檢測瀏覽器是否能播放指定的音頻/視頻類型 | | [load()](/tags/av_met_load.asp "HTML5 Audio/Video DOM load() 方法") | 重新加載音頻/視頻元素 | | [play()](/tags/av_met_play.asp "HTML5 Audio/Video DOM play() 方法") | 開始播放音頻/視頻 | | [pause()](/tags/av_met_pause.asp "HTML5 Audio/Video DOM pause() 方法") | 暫停當前播放的音頻/視頻 | ## HTML5 Audio/Video 屬性 | 屬性 | 描述 | | --- | --- | | [audioTracks](/tags/av_prop_audiotracks.asp "HTML5 Audio/Video DOM audioTracks 屬性") | 返回表示可用音軌的 AudioTrackList 對象 | | [autoplay](/tags/av_prop_autoplay.asp "HTML5 Audio/Video DOM autoplay 屬性") | 設置或返回是否在加載完成后隨即播放音頻/視頻 | | [buffered](/tags/av_prop_buffered.asp "HTML5 Audio/Video DOM buffered 屬性") | 返回表示音頻/視頻已緩沖部分的 TimeRanges 對象 | | [controller](/tags/av_prop_controller.asp "HTML5 Audio/Video DOM controller 屬性") | 返回表示音頻/視頻當前媒體控制器的 MediaController 對象 | | [controls](/tags/av_prop_controls.asp "HTML5 Audio/Video DOM controls 屬性") | 設置或返回音頻/視頻是否顯示控件（比如播放/暫停等） | | crossOrigin | 設置或返回音頻/視頻的 CORS 設置 | | [currentSrc](/tags/av_prop_currentsrc.asp "HTML5 Audio/Video DOM currentSrc 屬性") | 返回當前音頻/視頻的 URL | | [currentTime](/tags/av_prop_currenttime.asp "HTML5 Audio/Video DOM currentTime 屬性") | 設置或返回音頻/視頻中的當前播放位置（以秒計） | | [defaultMuted](/tags/av_prop_defaultmuted.asp "HTML5 Audio/Video DOM defaultMuted 屬性") | 設置或返回音頻/視頻默認是否靜音 | | [defaultPlaybackRate](/tags/av_prop_defaultplaybackrate.asp "HTML5 Audio/Video DOM defaultPlaybackRate 屬性") | 設置或返回音頻/視頻的默認播放速度 | | [duration](/tags/av_prop_duration.asp "HTML5 Audio/Video DOM duration 屬性") | 返回當前音頻/視頻的長度（以秒計） | | [ended](/tags/av_prop_ended.asp "HTML5 Audio/Video DOM ended 屬性") | 返回音頻/視頻的播放是否已結束 | | [error](/tags/av_prop_error.asp "HTML5 Audio/Video DOM error 屬性") | 返回表示音頻/視頻錯誤狀態的 MediaError 對象 | | [loop](/tags/av_prop_loop.asp "HTML5 Audio/Video DOM loop 屬性") | 設置或返回音頻/視頻是否應在結束時重新播放 | | [mediaGroup](/tags/av_prop_mediagroup.asp "HTML5 Audio/Video DOM mediaGroup 屬性") | 設置或返回音頻/視頻所屬的組合（用于連接多個音頻/視頻元素） | | [muted](/tags/av_prop_muted.asp "HTML5 Audio/Video DOM muted 屬性") | 設置或返回音頻/視頻是否靜音 | | [networkState](/tags/av_prop_networkstate.asp "HTML5 Audio/Video DOM networkState 屬性") | 返回音頻/視頻的當前網絡狀態 | | [paused](/tags/av_prop_paused.asp "HTML5 Audio/Video DOM paused 屬性") | 設置或返回音頻/視頻是否暫停 | | [playbackRate](/tags/av_prop_playbackrate.asp "HTML5 Audio/Video DOM playbackRate 屬性") | 設置或返回音頻/視頻播放的速度 | | [played](/tags/av_prop_played.asp "HTML5 Audio/Video DOM played 屬性") | 返回表示音頻/視頻已播放部分的 TimeRanges 對象 | | [preload](/tags/av_prop_preload.asp "HTML5 Audio/Video DOM preload 屬性") | 設置或返回音頻/視頻是否應該在頁面加載后進行加載 | | [readyState](/tags/av_prop_readystate.asp "HTML5 Audio/Video DOM readyState 屬性") | 返回音頻/視頻當前的就緒狀態 | | [seekable](/tags/av_prop_seekable.asp "HTML5 Audio/Video DOM seekable 屬性") | 返回表示音頻/視頻可尋址部分的 TimeRanges 對象 | | [seeking](/tags/av_prop_seeking.asp "HTML5 Audio/Video DOM seeking 屬性") | 返回用戶是否正在音頻/視頻中進行查找 | | [src](/tags/av_prop_src.asp "HTML5 Audio/Video DOM src 屬性") | 設置或返回音頻/視頻元素的當前來源 | | [startDate](/tags/av_prop_startdate.asp "HTML5 Audio/Video DOM startDate 屬性") | 返回表示當前時間偏移的 Date 對象 | | [textTracks](/tags/av_prop_texttracks.asp "HTML5 Audio/Video DOM textTracks 屬性") | 返回表示可用文本軌道的 TextTrackList 對象 | | [videoTracks](/tags/av_prop_videotracks.asp "HTML5 Audio/Video DOM videoTracks 屬性") | 返回表示可用視頻軌道的 VideoTrackList 對象 | | [volume](/tags/av_prop_volume.asp "HTML5 Audio/Video DOM volume 屬性") | 設置或返回音頻/視頻的音量 | ## HTML5 Audio/Video 事件 | 事件 | 描述 | | --- | --- | | abort | 當音頻/視頻的加載已放棄時 | | [canplay](/tags/av_event_canplay.asp "HTML5 Audio/Video DOM canplay 事件") | 當瀏覽器可以播放音頻/視頻時 | | [canplaythrough](/tags/av_event_canplaythrough.asp "HTML5 Audio/Video DOM canplaythrough 事件") | 當瀏覽器可在不因緩沖而停頓的情況下進行播放時 | | [durationchange](/tags/av_event_durationchange.asp "HTML5 Audio/Video DOM durationchange 事件") | 當音頻/視頻的時長已更改時 | | emptied | 當目前的播放列表為空時 | | ended | 當目前的播放列表已結束時 | | error | 當在音頻/視頻加載期間發生錯誤時 | | [loadeddata](/tags/av_event_loadeddata.asp "HTML5 Audio/Video DOM loadeddata 事件") | 當瀏覽器已加載音頻/視頻的當前幀時 | | [loadedmetadata](/tags/av_event_loadedmetadata.asp "HTML5 Audio/Video DOM loadedmetadata 事件") | 當瀏覽器已加載音頻/視頻的元數據時 | | [loadstart](/tags/av_event_loadstart.asp "HTML5 Audio/Video DOM loadstart 事件") | 當瀏覽器開始查找音頻/視頻時 | | pause | 當音頻/視頻已暫停時 | | play | 當音頻/視頻已開始或不再暫停時 | | playing | 當音頻/視頻在已因緩沖而暫停或停止后已就緒時 | | [progress](/tags/av_event_progress.asp "HTML5 Audio/Video DOM progress 事件") | 當瀏覽器正在下載音頻/視頻時 | | ratechange | 當音頻/視頻的播放速度已更改時 | | seeked | 當用戶已移動/跳躍到音頻/視頻中的新位置時 | | seeking | 當用戶開始移動/跳躍到音頻/視頻中的新位置時 | | stalled | 當瀏覽器嘗試獲取媒體數據，但數據不可用時 | | suspend | 當瀏覽器刻意不獲取媒體數據時 | | timeupdate | 當目前的播放位置已更改時 | | volumechange | 當音量已更改時 | | waiting | 當視頻由于需要緩沖下一幀而停止 |