RTCRtpTransceiver: stop() 方法

Baseline 已廣泛支援

此特性已得到良好確立，並可在多種裝置和瀏覽器版本上執行。自 2021 年 1 月起，所有瀏覽器均已支援此特性。

RTCRtpTransceiver 介面中的 stop() 方法透過停止關聯的 RTCRtpSender 和 RTCRtpReceiver 來永久停止收發器。

語法

stop()

異常

InvalidStateError DOMException: 如果收發器所屬的 RTCPeerConnection 已關閉，則會丟擲此異常。

當您對收發器呼叫 stop() 時，傳送器會立即停止傳送媒體，並且其每個 RTP 流都會使用 RTCP "BYE" 訊息關閉。然後接收器停止接收媒體；接收器的 track 會被停止，收發器的 direction 會變為 stopped。透過向收發器的 RTCPeerConnection 傳送 negotiationneeded 事件來觸發重新協商，以便連線可以適應此更改。

如果收發器已停止，則此方法無效。您可以透過將 currentDirection 與 "stopped" 進行比較來檢查它是否已停止。

注意： 規範的早期版本使用已棄用的 stopped 已棄用屬性來指示收發器是否已停止。