HTMLMediaElement.audioTracks

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

audioTracksHTMLMediaElement オブジェクトの読み取り専用プロパティで、メディア要素の音声トラックを表すすべての AudioTrack オブジェクトを列挙した AudioTrackList オブジェクトを返します。

このメディア要素は、<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 (let i = 0; i < video.audioTracks.length; i += 1) {
  video.audioTracks[i].enabled = false;
}

仕様書

Specification
HTML Standard
# dom-media-audiotracks-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報