MediaStream: addtrack イベント

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2017年9月以降、すべてのブラウザーで利用可能です。

addtrack イベントは、新しい MediaStreamTrack オブジェクトが MediaStream に追加されたときに発行されます。

このイベントはキャンセル不可で、バブリングしません。

構文

このイベント名を addEventListener() などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

addEventListener("addtrack", (event) => {});

onaddtrack = (event) => {};

MediaStreamTrackEvent です。 Event から継承しています。

親インターフェイスである Event から継承したプロパティもあります。

MediaStreamTrackEvent.track 読取専用: MediaStreamTrack オブジェクトで、このストリームに追加されたトラックを表します。

addEventListener() を使用すると次にようになります。

const stream = new MediaStream();

stream.addEventListener("addtrack", (event) => {
  console.log(`New ${event.track.kind} track added`);
});

onaddtrack イベントハンドラープロパティを使用すると次にようになります。

const stream = new MediaStream();

stream.onaddtrack = (event) => {
  console.log(`New ${event.track.kind} track added`);
};

仕様書
Media Capture and Streams # event-mediastream-addtrack

このページは MDN の貢献者によって 2024年3月20日に最終更新されました。