HTMLMediaElement.audioTracks

草案: このページは完成していません。

HTMLMediaElement オブジェクトの読み取り専用の audioTracks プロパティは、メディア要素の音声トラックを表すすべての AudioTrack オブジェクトを列挙した AudioTrackList オブジェクトを返します。 メディア要素は、<audio> 要素または <video> 要素のどちらでもかまいません。

返されたリストはライブです。 つまり、トラックがメディア要素に追加されたり取り除かれたりすると、リストの内容は動的に変化します。 リストへの参照を取得したら、新しい音声トラックが追加されたのか既存のトラックが取り除かれたのかを検出するために変更を監視できます。 メディア要素のトラックリストへの変更を監視する方法の詳細については、AudioTrackListイベントハンドラを参照してください。

構文

var audioTracks = mediaElement.audioTracks;

メディア要素に含まれる音声トラックのリストを表す AudioTrackList オブジェクト。 トラックのリストは、配列記法や、オブジェクトの getTrackById() メソッドを使ってアクセスできます。

各トラックは、そのトラックに関する情報を提供する AudioTrack オブジェクトによって表されます。

この例では、特定の要素のすべての音声トラックをミュートしています。

HTML

HTML は、要素自体を確立します。

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

JavaScript

JavaScript コードは、動画要素の音声トラックのミュートを処理します。

var video = document.getElementById("video");

for (var i = 0; i < video.audioTracks.length; i += 1) {
  video.audioTracks[i].enabled = false;
}

仕様

仕様 状態 コメント
HTML Living Standard
HTMLMediaElement.audioTracks の定義
現行の標準 HTML5 から変更なし
HTML5
HTMLMediaElement.audioTracks の定義
勧告 初期定義

ブラウザーの対応

BCD tables only load in the browser

関連情報