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