RTCTrackEvent: RTCTrackEvent() Konstruktor

Baseline Widely available

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

Der RTCTrackEvent()-Konstruktor erstellt und gibt ein neues RTCTrackEvent-Objekt zurück, das konfiguriert ist, um den Track zu beschreiben, der zur RTCPeerConnection hinzugefügt wurde.

Im Allgemeinen werden Sie diesen Konstruktor nicht benötigen, da RTCTrackEvent-Objekte von WebRTC erstellt und an den ontrack-Ereignishandler Ihres RTCPeerConnector nach Bedarf geliefert werden.

Syntax

js
new RTCTrackEvent(type, options)

Parameter

type

Ein String mit dem Namen des Ereignisses. Es ist groß- und kleinschreibungsempfindlich und Browser setzen es immer auf track.

options

Ein Objekt, das, zusätzlich zu den in Event() definierten Eigenschaften, folgende Eigenschaften haben kann:

receiver

Der RTCRtpReceiver, der verwendet wird, um die Medien des Tracks zu empfangen.

streams Optional

Ein Array von MediaStream-Objekten, die jeweils die Streams darstellen, die den entsprechenden Track des Ereignisses bilden. Standardmäßig ist es ein leeres Array.

track

Der MediaStreamTrack, mit dem das Ereignis verknüpft ist.

transceiver

Der RTCRtpTransceiver, der mit dem Ereignis verknüpft ist.

Rückgabewert

Ein neues RTCTrackEvent, das einen Track beschreibt, der zur RTCPeerConnection hinzugefügt wurde.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser