RTCRtpTransceiver: stop()-Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2021 browserübergreifend verfügbar.

Die stop()-Methode der RTCRtpTransceiver-Schnittstelle stoppt dauerhaft den Transceiver, indem sowohl der zugehörige RTCRtpSender als auch der RTCRtpReceiver gestoppt werden.

Syntax

stop()

Ausnahmen

InvalidStateError DOMException: Wird ausgelöst, wenn die RTCPeerConnection, deren Mitglied der Transceiver ist, geschlossen ist.

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.