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 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

Siehe auch