RTCPeerConnection: removeTrack()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Januar 2020.
Die removeTrack()
-Methode der RTCPeerConnection
-Schnittstelle teilt dem lokalen Ende der Verbindung mit, dass es aufhören soll, Medien von dem angegebenen Track zu senden, ohne den entsprechenden RTCRtpSender
aus der Liste der Sender zu entfernen, wie sie von RTCPeerConnection.getSenders()
berichtet wird. Wenn der Track bereits gestoppt ist oder sich nicht in der Senderliste der Verbindung befindet, hat diese Methode keine Wirkung.
Wenn die Verbindung bereits verhandelt wurde (signalingState
ist auf "stable"
gesetzt), wird sie als neu zu verhandeln markiert; der entfernte Peer wird die Änderung erst bemerken, wenn diese Verhandlung erfolgt. Ein negotiationneeded
-Ereignis wird an die RTCPeerConnection
gesendet, um dem lokalen Ende mitzuteilen, dass diese Verhandlung stattfinden muss.
Syntax
removeTrack(sender)
Parameter
sender
-
Ein
RTCRtpSender
, der den zu entfernenden Sender aus der Verbindung angibt.
Rückgabewert
undefined
.
Ausnahmen
InvalidStateError
DOMException
-
Wird ausgelöst, wenn die Verbindung nicht geöffnet ist.
Beispiel
Dieses Beispiel fügt einer Verbindung einen Videotrack hinzu und richtet einen Listener auf eine Schaltfläche zum Schließen ein, der den Track entfernt, wenn der Benutzer auf die Schaltfläche klickt.
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();
});
Spezifikationen
Specification |
---|
WebRTC: Real-Time Communication in Browsers> # dom-rtcpeerconnection-removetrack> |
Browser-Kompatibilität
Loading…