RTCPeerConnection: метод removeTrack()

Метод removeTrack() интерфейса RTCPeerConnection сообщает локальной части соединения о прекращении отправки медиаданных от указанного трака, не удаляя при этом соответствующий объект RTCRtpSender из списка отправителей, как сообщается методом RTCPeerConnection.getSenders(). Если трак уже остановлен или не входит в список отправителей соединения, этот метод не имеет эффекта.

Если соединение уже было согласовано (signalingState установлено в "stable"), оно помечается как требующее повторного согласования; удалённое соединение не увидит изменений до тех пор, пока это согласование не произойдёт. В RTCPeerConnection отправляется событие negotiationneeded, чтобы сообщить локальной части о необходимости согласования.

sender

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

undefined.

InvalidStateError DOMException

Бросается, если соединение не открыто.

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

let pc;
let sender;
navigator.getUserMedia({ video: true }, (stream) => {
  pc = new RTCPeerConnection();
  const [track] = stream.getVideoTracks();
  sender = pc.addTrack(track, stream);
});

document.getElementById("closeButton").addEventListener(
  "click",
  (event) => {
    pc.removeTrack(sender);
    pc.close();
  },
  false,
);

• API WebRTC