RTCPeerConnection: событие track

Событие track отправляется обработчику событий ontrack на RTCPeerConnection после добавления нового трека в RTCRtpReceiver, который является частью соединения.

К моменту доставки этого события новый трек полностью добавлен в соединение peer. Подробности см. в разделе Типы событий трека.

Это событие не может быть отменено и не распространяется.

Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика событий.

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

ontrack = (event) => {};

Объект RTCTrackEvent. Наследуется от Event.

Поскольку RTCTrackEvent основано на Event, его свойства также доступны.

receiver Только для чтения

Используемый RTCRtpReceiver трек, добавленный в RTCPeerConnection.

streams Только для чтения Необязательно

Массив объектов MediaStream, каждый из которых представляет один из потоков мультимедиа, к которому принадлежит добавленный track. По умолчанию массив пустой, что указывает на бес-потоковый трек.

track Только для чтения

Добавленный в соединение MediaStreamTrack.

transceiver Только для чтения

Используемый RTCRtpTransceiver новый трек.

В этом примере показан код, который создает новый RTCPeerConnection, затем добавляет новый обработчик события track.

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,
);

Обработчик события назначает первый поток нового трека существующему элементу <video>, идентифицированному с помощью переменной videoElement.

Вы также можете назначить функцию обработчика события свойству ontrack вместо использования addEventListener().

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