RTCRtpSender: метод setStreams()

Метод RTCRtpSender setStreams() связывает трак track отправителя со специфицированными объектами MediaStream.

mediaStreamN Необязательно

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

None (undefined).

InvalidStateError DOMException

Выбрасывается, если соединение отправителя закрыто.

setStreams() является чисто аддитивным. Он не удаляет трак из потоков; он добавляет его к новым. Если вы указываете потоки, к которым трак уже принадлежит, этот поток не затронут.

После добавления трака ко всем потокам будет инициирована повторная установка соединения событием negotiationneeded, отправляемым в объект RTCPeerConnection, к которому принадлежит отправитель.

В этом примере все траки объекта RTCPeerConnection добавляются к указанному потоку.

function addTracksToStream(stream) {
  let senders = pc.getSenders();

  senders.forEach((sender) => {
    if (sender.track && sender.transport.state === connected) {
      sender.setStreams(stream);
    }
  });
}

После вызова метода RTCPeerConnection getSenders() для получения списка отправителей подключения, функция addTracksToStream() перебирает список. Для каждого отправителя, если трак отправителя не null и состояние транспорта connected, мы вызываем setStreams() для добавления трака к указанному stream.