MediaStream: addtrack イベント

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

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

関連情報