RTCPeerConnection: метод addStream()

Метод addStream() интерфейса RTCPeerConnection добавляет MediaStream в качестве локального источника аудио или видео. Вместо использования этого устаревшего метода, вы должны использовать addTrack() для каждого трека, который вы хотите отправить удалённому узлу.

Если signalingState установлено в значение closed, генерируется InvalidStateError. Если signalingState установлено в значение stable, событие negotiationneeded отправляется на RTCPeerConnection, чтобы указать, что необходимо повторить переговорный процесс ICE для учёта нового потока.

mediaStream

Объект MediaStream, указывающий поток, который нужно добавить к соединению веб-RTC.

Ничего.

В этом простом примере добавляется аудио- и видеопоток, поступающий с камеры пользователя, к соединению.

navigator.mediaDevices.getUserMedia({ video: true, audio: true }, (stream) => {
  const pc = new RTCPeerConnection();
  pc.addStream(stream);
});

Совместимость позволяя, вы должны обновить свой код, используя вместо этого метод addTrack():

navigator.getUserMedia({ video: true, audio: true }, (stream) => {
  const pc = new RTCPeerConnection();
  stream.getTracks().forEach((track) => {
    pc.addTrack(track, stream);
  });
});

Новый API addTrack() избегает путаницы в том, как последующие изменения в составе треков потока влияют на соединение peer (они не влияют).

Исключением является Chrome, где addStream() действительно делает соединение peer чувствительным к последующим изменениям потока (хотя такие изменения не вызывают события negotiationneeded). Если вы полагаетесь на поведение Chrome, обратите внимание, что в других браузерах его нет. Вы можете написать совместимый с веб-страницей код, используя обнаружение функций вместо этого:

// Add a track to a stream and the peer connection said stream was added to:

stream.addTrack(track);
if (pc.addTrack) {
  pc.addTrack(track, stream);
} else {
  // If you have code listening for negotiationneeded events:
  setTimeout(() => pc.dispatchEvent(new Event("negotiationneeded")));
}

// Remove a track from a stream and the peer connection said stream was added to:

stream.removeTrack(track);
if (pc.removeTrack) {
  pc.removeTrack(pc.getSenders().find((sender) => sender.track === track));
} else {
  // If you have code listening for negotiationneeded events:
  setTimeout(() => pc.dispatchEvent(new Event("negotiationneeded")));
}

• WebRTC