このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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 ⁨2017年9月⁩.

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

ブラウザーの互換性

関連情報