此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

RTCTrackEvent()

基线 广泛可用

自 2020年1月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

RTCTrackEvent() 构造函数创建并返回一个新的 RTCTrackEvent 对象,用于描述已经被添加到 RTCPeerConnection 的轨道。

通常,你不需要使用这个构造函数,例如 RTCTrackEvent 这样的对象会由 WebRTC 创建,并根据需要传递到 RTCPeerConnectorontrack 事件处理器上。

语法

js
new RTCTrackEvent(type, options)

参数

type

一个表示事件名称的字符串。大小写敏感,且浏览器始终将其设置为 track

options

一个对象,除了 Event() 中定义的对象,还可以使用以下属性:

receiver

一个 RTCRtpReceiver,用于接收轨道的媒体。

streams 可选

一个 MediaStream 对象的数组,表示构成事件对应的轨道的流。它默认为一个空数组。 It defaults to an empty array.

track

一个与事件关联的 MediaStreamTrack

transceiver

一个与事件关联的 RTCRtpTransceiver

返回值

一个新的 RTCTrackEvent,用于描述已经被添加到 RTCPeerConnection 的轨道。

规范

规范
WebRTC: Real-Time Communication in Browsers
# dom-rtctrackevent-constructor

浏览器兼容性