HTMLMediaElement: audioTracks 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

HTMLMediaElement 物件上只讀的 audioTracks 屬性會返回一個 AudioTrackList 物件,該物件列出了表示媒體元素的音訊軌道的 AudioTrack 物件。

該媒體元素可以是 <audio> 元素,也可以是 <video> 元素。

返回的列表是即時的;也就是說,隨著軌道的新增和移除,列表的內容會動態變化。一旦你有了列表的引用,你就可以監視它的變化來檢測何時添加了新的音訊軌道或移除了現有的音訊軌道。請參閱 AudioTrackList 事件,瞭解更多關於監視媒體元素軌道列表變化的資訊。

一個表示媒體元素中音訊軌道列表的 AudioTrackList 物件。可以使用陣列表示法,或使用物件的 getTrackById() 方法來訪問軌道列表。

每個軌道都由一個 AudioTrack 物件表示,該物件提供了有關軌道的​​資訊。

示例

在此示例中,給定元素的​​所有音訊軌道都被靜音。

HTML

HTML 建立了元素本身。

html
<video id="video" src="somevideo.mp4"></video>

JavaScript

JavaScript 程式碼負責靜音影片元素的​​音訊軌道。

js
const video = document.getElementById("video");

for (const track of video.audioTracks) {
  track.enabled = false;
}

規範

規範
HTML
# dom-media-audiotracks-dev

瀏覽器相容性

另見