WebRTC
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 RTCRtpReceiver.track is stopped, and the transceiver's RTCRtpTransceiver.direction is changed to stopped.
Renegotiation is triggered by sending a RTCPeerConnection.negotiationneeded_event 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 RTCRtpTransceiver.currentDirection to "stopped".
[!NOTE] Earlier versions of the specification used the deprecated RTCRtpTransceiver.stopped property to indicate if the transceiver has stopped.
Specifications
Browser compatibility
See also
- WebRTC API
- Introduction to the Real-time Transport Protocol (RTP)
- MediaStreamTrack
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
