RTCRtpTransceiver

Baseline 廣泛可用 *

此特性已成熟穩定,適用於多種裝置和瀏覽器版本。自 2018 年 10 月起,它已在各瀏覽器中可用。

* 此特性的某些部分可能存在不同級別的支援。

WebRTC 介面 RTCRtpTransceiver 描述了一個永久配對的 RTCRtpSenderRTCRtpReceiver,以及一些共享狀態。

每個 SDP 媒體部分描述了一個雙向 SRTP(“安全即時傳輸協議”)流(如果存在,則不包括 RTCDataChannel 的媒體部分)。這種傳送和接收 SRTP 流的配對對某些應用程式很重要,因此 RTCRtpTransceiver 用於表示這種配對,以及來自媒體部分的其它重要狀態。每個非停用狀態的 SRTP 媒體部分始終由一個且僅一個 transceiver 表示。

Transceiver 使用其 mid 屬性進行唯一標識,該屬性與對應的 m-line 的媒體 ID (mid) 相同。如果 RTCRtpTransceivermid 非空,則它與 m-line **關聯**;否則,它被視為解除關聯。

例項屬性

currentDirection 只讀

一個只讀字串,表示 transceiver 當前協商的傳輸方向,如果 transceiver 從未參與過 offer/answer 交換,則為 null。要更改 transceiver 的傳輸方向,請設定 direction 屬性的值。

direction

一個用於設定 transceiver 首選傳輸方向的字串。

mid 只讀

與此 transceiver 關聯的 m-line 的媒體 ID。當應用本地或遠端描述時,此關聯會盡可能建立。如果未應用本地或遠端描述,或者其關聯的 m-line 被遠端 offer 或任何 answer 拒絕,則此欄位為 null

receiver 只讀

負責接收和解碼傳入媒體的 RTCRtpReceiver 物件。

sender 只讀

負責將資料編碼併發送到遠端對等方的 RTCRtpSender 物件。

stopped 已棄用

指示配對的 RTCRtpSenderRTCRtpReceiver 的傳送和接收是否已永久停用,無論是由於 SDP offer/answer,還是由於呼叫了 stop()

例項方法

setCodecPreferences()

配置 transceiver 的首選編解碼器列表,覆蓋 使用者代理設定。

stop()

永久停止 RTCRtpTransceiver。關聯的傳送方停止傳送資料,關聯的接收方也停止接收和解碼傳入資料。

規範

規範
WebRTC:瀏覽器中的即時通訊
# rtcrtptransceiver-interface

瀏覽器相容性

另見