MediaStream: addtrack イベント

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

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

構文

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

js

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

onaddtrack = event => { };

イベント型

MediaStreamTrackEvent (en-US) です。 Event から継承しています。

Event MediaStreamTrackEvent (en-US)

イベントプロパティ

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

track 読取専用

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

例

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

js

let stream = new MediaStream();

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

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

js

let 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

関連情報