RTCPeerConnection: track Ereignis

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

addEventListener("track", (event) => {});

ontrack = (event) => {};

Ein RTCTrackEvent. Erbt von Event.

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

receiver Nur lesbar

Der RTCRtpReceiver, der von dem hinzugefügten Track zur RTCPeerConnection verwendet wird.

streams Nur lesbar Optional

Ein Array von MediaStream-Objekten, die jeweils einen der Medienströme darstellen, 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 vom neuen Track verwendet wird.

Dieses Beispiel zeigt Code, der eine neue RTCPeerConnection erstellt und dann einen neuen track-Ereignishandler hinzufügt.

pc = new RTCPeerConnection({
  iceServers: [
    {
      urls: "turn:fake.turn-server.url",
      username: "some username",
      credential: "some-password",
    },
  ],
});

pc.addEventListener(
  "track",
  (e) => {
    videoElement.srcObject = e.streams[0];
    hangupButton.disabled = false;
  },
  false,
);

Der Ereignishandler ordnet den ersten Stream des neuen Tracks einem bestehenden <video>-Element zu, das mit der Variablen videoElement identifiziert wird.

Sie können die Ereignishandlungsfunktion auch der ontrack-Eigenschaft zuweisen, anstatt addEventListener() zu verwenden.

pc.ontrack = (e) => {
  videoElement.srcObject = e.streams[0];
  hangupButton.disabled = false;
  return false;
};