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

js
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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
stop()

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch