RTCRtpTransceiver:stop() 方法

RTCRtpTransceiver 接口中,stop() 方法通过停止关联的 RTCRtpSenderRTCRtpReceiver 来永久停止转发器。

语法

js
stop()

参数

无。

返回值

无 (undefined)。

异常

InvalidStateError DOMException

如果转发器所属的 RTCPeerConnection 已关闭,则抛出此异常。

描述

当您在转发器上调用 stop() 时,发送方会立即停止发送媒体,并且其每个 RTP 流都将使用 RTCP "BYE" 消息关闭。然后,接收方停止接收媒体;接收方的 track 停止,并且转发器的 direction 更改为 stopped。通过向转发器所属的 RTCPeerConnection 发送 negotiationneeded 事件来触发重新协商,以便连接能够适应更改。

如果转发器已停止,则此方法不执行任何操作。您可以通过将 currentDirection"stopped" 进行比较来检查它是否已停止。

注意:早期版本的规范使用已弃用的 stopped 已弃用 属性来指示转发器是否已停止。

规范

规范
WebRTC:浏览器中的实时通信
# dom-rtcrtptransceiver-stop

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅