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 の定義
勧告 初期定義

ブラウザーの対応

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
audioTracksChrome 未対応 なしEdge 完全対応 12Firefox 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE ? Opera 完全対応 ありSafari 完全対応 ありWebView Android 未対応 なしChrome Android 未対応 なしFirefox Android 完全対応 33
無効
完全対応 33
無効
無効 From version 33: this feature is behind the media.track.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android ?

凡例

完全対応  
完全対応
未対応  
未対応
実装状況不明  
実装状況不明
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。

関連情報