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
# dom-media-audiotracks-dev

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
audioTracks

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
User must explicitly enable this feature.
Has more compatibility info.

関連情報