RTCRtpTransceiver:stop() 方法
在 RTCRtpTransceiver
接口中,stop()
方法通过停止关联的 RTCRtpSender
和 RTCRtpReceiver
来永久停止转发器。
语法
js
stop()
参数
无。
返回值
无 (undefined
)。
异常
InvalidStateError
DOMException
-
如果转发器所属的
RTCPeerConnection
已关闭,则抛出此异常。
描述
当您在转发器上调用 stop()
时,发送方会立即停止发送媒体,并且其每个 RTP 流都将使用 RTCP "BYE"
消息关闭。然后,接收方停止接收媒体;接收方的 track
停止,并且转发器的 direction
更改为 stopped
。通过向转发器所属的 RTCPeerConnection
发送 negotiationneeded
事件来触发重新协商,以便连接能够适应更改。
如果转发器已停止,则此方法不执行任何操作。您可以通过将 currentDirection
与 "stopped"
进行比较来检查它是否已停止。
注意:早期版本的规范使用已弃用的 stopped
已弃用 属性来指示转发器是否已停止。
规范
规范 |
---|
WebRTC:浏览器中的实时通信 # dom-rtcrtptransceiver-stop |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。