MediaStream: addtrack イベント

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

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

構文

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

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

onaddtrack = (event) => {};

イベント型

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

Event MediaStreamTrackEvent

イベントプロパティ

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

MediaStreamTrackEvent.track 読取専用

MediaStreamTrack オブジェクトで、このストリームに追加されたトラックを表します。

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

js
const stream = new MediaStream();

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

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

js
const stream = new MediaStream();

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

仕様書

Specification
Media Capture and Streams
# event-mediastream-addtrack

ブラウザーの互換性

BCD tables only load in the browser

関連情報