MediaStream.getAudioTracks()

この記事は翻訳が完了していません。 この記事の翻訳にご協力ください

MediaStream インタフェースのgetAudioTracks() メソッドは、そのストリームのtrack setの中から、MediaStreamTrack.kindがaudioであるMediaStreamTrack を表すオブジェクトの配列を返します。

文法

var mediaStreamTracks = mediaStream.getAudioTracks()

引数

なし。

戻り値

ストリームに含まれるオーディオトラックであるMediaStreamTrackオブジェクトの配列。オーディオトラックとはkindプロパティが audioのトラックです。ストリーム内にオーディオトラックがない場合はこの配列は空になります。

注意: トラックの順番は仕様では定義されておらず、実際、getAudioTracks()を呼び出すたびに変わりえます。

このAPIの初期バージョンでは、オーディオストリーム内の要素の型として使われていた特別なAudioStreamTrackインタフェースを含んでいました。しかし、こちらは後ほど、MediaStreamTrackインタフェース内に統合されました。

例

この例では、Webカメラの音声とビデオをgetUserMedia()を使ってストリームとして取得し、そのストリームを<video>要素に設定します。その後、終了時にストリーム内の最初のオーディオトラックを停止するタイマーを設定します。

navigator.mediaDevices.getUserMedia({audio: true, video: true})
.then(mediaStream => {
  document.querySelector('video').srcObject = mediaStream;
  // Stop the audio stream after 5 seconds
  setTimeout(() => {
    const tracks = mediaStream.getAudioTracks()
    tracks[0].stop()
  }, 5000)
})

仕様

仕様 状況 コメント
Media Capture and Streams
getAudioTracks() の定義		 勧告候補 Initial definition.

ブラウザ互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
getAudioTracksChrome 完全対応 26Edge 完全対応 12Firefox 完全対応 22
補足
完全対応 22
補足
補足 Prior to Firefox 64, this method returned an array of AudioStreamTrack objects. However, MediaStreamTrack has now subsumed that interface's functionality.
IE 未対応 なしOpera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 37Chrome Android 完全対応 26Firefox Android 完全対応 22
補足
完全対応 22
補足
補足 Prior to Firefox 64, this method returned an array of AudioStreamTrack objects. However, MediaStreamTrack has now subsumed that interface's functionality.
Opera Android 未対応 なしSafari iOS 完全対応 ありSamsung Internet Android 完全対応 1.5

凡例

完全対応  
完全対応
未対応  
未対応
実装ノートを参照してください。
実装ノートを参照してください。