RTCRtpSender

Baseline 廣泛可用 *

此功能已非常成熟,可在許多裝置和瀏覽器版本上執行。自 2018 年 1 月起,它已在所有瀏覽器中可用。

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

RTCRtpSender 介面提供了控制和獲取有關特定 MediaStreamTrack 如何被編碼併發送給遠端對等端(peer)的詳細資訊的能力。

透過它,您可以配置相應軌道的編碼,獲取裝置媒體功能的資訊,等等。您還可以訪問一個 RTCDTMFSender,它可用於向遠端對等端傳送 DTMF 碼(用於模擬使用者按下電話撥號盤上的按鈕)。

例項屬性

RTCRtpSender.dtmf 只讀

一個 RTCDTMFSender,可用於在 RTCRtpSender 物件表示的 RTP 會話上使用 telephone-event 有效負載傳送 DTMF 訊號。如果為 null,則表示該軌道和/或連線不支援 DTMF。只有音訊軌道支援 DTMF。

RTCRtpSender.track 只讀

RTCRtpSender 處理的 MediaStreamTrack。如果 tracknull,則 RTCRtpSender 不會傳輸任何內容。

RTCRtpSender.transport 只讀

傳送方用於交換用於管理媒體傳輸和控制資料的 RTP 和 RTCP 資料包的 RTCDtlsTransport。此值在傳輸建立之前為 null。在使用捆綁(bundling)時,可能會有多個收發器(transceiver)共享同一個傳輸物件。

RTCRtpSender.transform

一個 RTCRtpScriptTransform用於將工作執行緒中執行的轉換流(TransformStream)插入傳送管道,從而允許在編碼器輸出之後、傳送之前,將轉換應用於編碼的影片和音訊幀。

已廢棄的屬性

rtcpTransport 已棄用

此屬性已被移除;RTP 和 RTCP 傳輸已合併為一個單獨的傳輸。請改用 transport 屬性。

靜態方法

RTCRtpSender.getCapabilities()

返回一個描述系統傳送指定型別媒體資料的能力的物件。

例項方法

RTCRtpSender.getParameters()

返回一個描述 track 的當前媒體編碼和傳輸配置的物件。

RTCRtpSender.getStats()

返回一個 Promise,該 Promise 將會以一個 RTCStatsReport 來解析,該報告提供了透過此 RTCRtpSender 傳送的所有出站流的統計資料。

RTCRtpSender.setParameters()

應用引數更改,這些引數配置了 track 如何被編碼並傳輸到遠端對等端。

RTCRtpSender.setStreams()

設定與此傳送方正在傳輸的 track 相關聯的

RTCRtpSender.replaceTrack()

嘗試用另一個軌道替換 RTCRtpSender 當前正在傳送的軌道,而不執行重新協商。此方法可用於,例如,在裝置的後置和前置攝像頭之間切換。

規範

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

瀏覽器相容性

另見