MediaStream: addtrack 事件

Baseline 已廣泛支援

此功能已成熟,可跨多種裝置和瀏覽器版本使用。自 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`);
};

規範

規範
媒體捕獲和流
# event-mediastream-addtrack

瀏覽器相容性

另見