RTCTrackEvent

Интерфейс API WebRTC RTCTrackEvent представляет событие track, которое отправляется при добавлении нового MediaStreamTrack к RTCRtpReceiver, который является частью RTCPeerConnection.

Целью является объект RTCPeerConnection, к которому добавляется траектория.

Это событие отправляется слоем WebRTC на веб-сайт или приложение, поэтому обычно вам не нужно создавать RTCTrackEvent самостоятельно.

RTCTrackEvent()

Создает и возвращает новый объект RTCTrackEvent. Вам, вероятно, не нужно создавать новые события отслеживания самостоятельно, так как они обычно создаются инфраструктурой WebRTC и отправляются обработчику события ontrack соединения.

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

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

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

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

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

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

MediaStreamTrack, который был добавлен к соединению.

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

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

Существует только один тип события отслеживания.

Событие track отправляется в RTCPeerConnection при добавлении новой траектории к соединению. К моменту доставки события track в обработчик события ontrack RTCPeerConnection, новая медиа завершила переговоры для определенного RTCRtpReceiver (который указан свойством receiver события).

Кроме того, MediaStreamTrack, указанный в свойстве track получателя, совпадает с track события, и траектория была добавлена к любым связанным удалённым объектам MediaStream.

Вы можете добавить обработчик события track, чтобы быть уведомлённым о доступности новой траектории, чтобы, например, прикрепить её медиа к элементу <video> с помощью RTCPeerConnection.addEventListener() или свойства обработчика события ontrack.

В этом простом примере создаётся обработчик события track, который устанавливает srcObject элемента <video> с ID video-box на первый поток в списке, переданном в массиве streams события.

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