RTCTrackEvent

RTCTrackEvent()

Erstellt und gibt ein neues RTCTrackEvent-Objekt zurück. Sie werden wahrscheinlich keine neuen Track-Ereignisse selbst erstellen müssen, da diese typischerweise von der WebRTC-Infrastruktur erstellt und an den ontrack-Ereignishandler der Verbindung gesendet werden.

Da RTCTrackEvent auf Event basiert, sind dessen Eigenschaften ebenfalls verfügbar.

receiver Nur lesbar

Der RTCRtpReceiver, der durch den Track verwendet wird, der zu der RTCPeerConnection hinzugefügt wurde.

streams Nur lesbar Optional

Ein Array von MediaStream-Objekten, von denen jedes einen der Medienstreams repräsentiert, zu denen der hinzugefügte track gehört. Standardmäßig ist das Array leer, was auf einen streamlosen Track hinweist.

track Nur lesbar

Der MediaStreamTrack, der zur Verbindung hinzugefügt wurde.

transceiver Nur lesbar

Der RTCRtpTransceiver, der durch den neuen Track verwendet wird.

Es gibt nur einen Typ von Track-Ereignis.

Das track-Ereignis wird an die RTCPeerConnection gesendet, wenn ein neuer Track zur Verbindung hinzugefügt wurde. Zu dem Zeitpunkt, zu dem das track-Ereignis an den ontrack-Handler der RTCPeerConnection geliefert wird, hat das neue Medium seine Verhandlung für einen spezifischen RTCRtpReceiver abgeschlossen (der durch die receiver-Eigenschaft des Ereignisses angegeben ist).

Zusätzlich ist der durch den Receiver angegebene track derselbe wie der durch das Ereignis angegebene track, und der Track wurde zu allen zugehörigen entfernten MediaStream-Objekten hinzugefügt.

Sie können einen track-Ereignislistener hinzufügen, um benachrichtigt zu werden, wenn der neue Track verfügbar ist, damit Sie beispielsweise dessen Medien an ein <video>-Element anhängen können, entweder mit RTCPeerConnection.addEventListener() oder der ontrack-Ereignishandler-Eigenschaft.

Dieses einfache Beispiel erstellt einen Ereignislistener für das track-Ereignis, das die srcObject des <video>-Elements mit der ID video-box auf den ersten Stream in der im streams-Array des Ereignisses übergebenen Liste setzt.

peerConnection.addEventListener(
  "track",
  (e) => {
    let videoElement = document.getElementById("video-box");
    videoElement.srcObject = e.streams[0];
  },
  false,
);