HTMLMediaElement: audioTracks プロパティ
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
audioTracks
は HTMLMediaElement
オブジェクトの読み取り専用プロパティで、メディア要素の音声トラックを表すすべての AudioTrack
オブジェクトを列挙した AudioTrackList
オブジェクトを返します。
このメディア要素は、<audio>
要素または <video>
要素のどちらでもかまいません。
返されたリストは生きています。つまり、トラックがメディア要素に追加、削除されると、リストの内容が動的に変更されます。一度リストへの参照を得れば、新しい音声トラックが追加されたり、既存のものが削除されたりしたときに、その変更を監視することができます。メディア要素のトラックリストの変更を監視する方法については、 AudioTrackList のイベントを参照してください。
値
メディア要素に含まれる音声トラックのリストを表す AudioTrackList
オブジェクト。トラックのリストは、配列記法や、オブジェクトの getTrackById()
メソッドを使ってアクセスできます。
各トラックは、そのトラックに関する情報を提供する AudioTrack
オブジェクトによって表されます。
例
この例では、特定の要素のすべての音声トラックをミュートしています。
HTML
HTML で、要素自体を確立します。
<video id="video" src="somevideo.mp4"></video>
JavaScript
JavaScript コードで、動画要素の音声トラックのミュートを処理します。
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
関連情報
HTMLMediaElement
:HTMLMediaElement.audioTracks
プロパティを定義しているインターフェイス<audio>
,<video>
AudioTrack
,AudioTrackList