RTCRtpTransceiver: stop()-Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
Die stop()
-Methode der RTCRtpTransceiver
-Schnittstelle stoppt dauerhaft den Transceiver, indem sowohl der zugehörige RTCRtpSender
als auch der RTCRtpReceiver
gestoppt werden.
Syntax
stop()
Parameter
Keine.
Rückgabewert
Keiner (undefined
).
Ausnahmen
InvalidStateError
DOMException
-
Wird ausgelöst, wenn die
RTCPeerConnection
, deren Mitglied der Transceiver ist, geschlossen ist.
Beschreibung
Wenn Sie stop()
auf einem Transceiver aufrufen, stoppt der Sender sofort das Senden von Medien, und jeder seiner RTP-Streams wird mithilfe der RTCP-"BYE"
-Nachricht geschlossen.
Der Empfänger hört dann auf, Medien zu empfangen; der track
des Empfängers wird gestoppt, und die direction
des Transceivers wird auf stopped
geändert.
Eine Neuverhandlung wird ausgelöst, indem ein negotiationneeded
-Ereignis an die RTCPeerConnection
des Transceivers gesendet wird, damit die Verbindung sich an die Änderung anpassen kann.
Die Methode tut nichts, wenn der Transceiver bereits gestoppt ist.
Sie können überprüfen, ob er gestoppt ist, indem Sie currentDirection
mit "stopped"
vergleichen.
Hinweis: Frühere Versionen der Spezifikation verwendeten die veraltete stopped
Veraltet
Eigenschaft, um anzuzeigen, ob der Transceiver gestoppt wurde.
Spezifikationen
Specification |
---|
WebRTC: Real-Time Communication in Browsers # dom-rtcrtptransceiver-stop |
Browser-Kompatibilität
BCD tables only load in the browser