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) | 未サポート | ? | ? | (有) |
関連項目
addtrack
イベントおよび、その型であるMediaStreamTrackEvent