web api instance method
RTCRtpTransceiver: stop() method
The stop() method in the RTCRtpTransceiver interface permanently stops the transceiver by stopping both the associated RTCRtpSender and
RTCRtpReceiver.
Syntax
stop()
Parameters
None.
Return value
None (undefined).
Exceptions
InvalidStateErrorDOMException- : Thrown if the
RTCPeerConnection, of which the transceiver is a member, is closed.
- : Thrown if the
Description
When you call stop() on a transceiver, the sender immediately stops sending media and each of its RTP streams are closed using the RTCP "BYE" message.
The receiver then stops receiving media; the receiver’s track is stopped, and the transceiver’s direction is changed to stopped.
Renegotiation is triggered by sending a negotiationneeded event to the transceiver’s RTCPeerConnection, so that the connection can adapt to the change.
The method does nothing if the transceiver is already stopped.
You can check whether it has stopped by comparing currentDirection to "stopped".
[!NOTE] Earlier versions of the specification used the deprecated
stoppedDeprecated property to indicate if the transceiver has stopped.