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 der RTCPeerConnection hinzugefügt wurde.

Im Allgemeinen müssen Sie diesen Konstruktor nicht verwenden, da RTCTrackEvent-Objekte von WebRTC erstellt und Ihrem RTCPeerConnection-Objekt durch den ontrack-Ereignishandler je nach Bedarf geliefert werden.

Syntax

js
new RTCTrackEvent(type, options)

Parameter

type

Ein String mit dem Namen des Ereignisses. Es ist groß-/kleinschreibungssensitiv und Browser setzen ihn immer auf track.

options

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

receiver

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

streams Optional

Ein Array von MediaStream-Objekten, das jeweils einen der Streams repräsentiert, die dem entsprechenden Track des Ereignisses entsprechen. 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 der RTCPeerConnection hinzugefügt wurde.

Spezifikationen

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

Browser-Kompatibilität