MediaStream.onaddtrack

MediaStream.onaddtrack プロパティは、EventHandlerであり、MediaStreamインスタンスでaddtrackイベントが発生した時に呼び出される関数です。このイベントは、メディアストリームへ新しいトラックが追加された時に発生します。このイベントはブラウザがストリームへ新しいトラックを追加した時に発生します。たとえば、RTCPeerConnectionが再交渉された時や、HTMLMediaElement.captureStream()を用いてキャプチャーが開始されたストリームが、新しいトラックを取得した時です。

JavaScriptのコードによって明示的にストリームへトラックを追加した場合(addTrack()の呼び出しによるもの)は、addtrackイベントは発生しません。

文法

MediaStream.onaddtrack = eventHandler;

値

どのトラックでaddtrackイベントが発生したのかを表現するためのMediaStreamTrackEventオブジェクトを引数として受け取る関数を設定してください。追加されたトラックは、イベントのtrackプロパティで表されます。

例

この例では、新しいトラックがストリームへ追加された時に、トラックのリストへ新しいアイテムを追加しています。新しいアイテムには、トラックのkind("audio"または"video")とlabelが表示されます。

stream.onaddtrack = function(event) {
  let trackList = document.getElementById("tracks");
  let label = document.createElement("li");

  label.innerHTML = event.track.kind + ": " + event.track.label;
  trackList.appendChild(label);
};

仕様

仕様 状況 コメント
Media Capture and Streams
MediaStream.onaddtrack の定義		 勧告候補 初版

ブラウザ互換性

現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。 この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。 手助けしていただける場合は、こちらから！
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (有) 50 (50) ? ? ?
Feature Android Android Webview Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android
Basic support ? ? 50.0 (50) 未サポート ? ? (有)

関連項目