RTCPeerConnection: addTransceiver() 方法

語法

addTransceiver(trackOrKind)
addTransceiver(trackOrKind, init)

引數

trackOrKind

要與收發器關聯的 MediaStreamTrack，或者用作接收器 track（進而作為 RTCRtpReceiver 本身）的 kind 的字串。

init 可選

一個用於在建立新收發器時指定任何選項的物件。可能的值為：

direction 可選

新收發器的首選方向。此值用於初始化新的 RTCRtpTransceiver 物件 RTCRtpTransceiver.direction 屬性。

sendEncodings 可選

在從 RTCRtpSender 傳送 RTP 媒體時允許的編碼陣列。這與傳遞給 RTCRtpSender.setParameters() 的 parameter.encodings 陣列相同。

streams 可選

要新增到收發器 RTCRtpReceiver 的 MediaStream 物件列表；當遠端對端的 RTCPeerConnection 發生 track 事件時，這些將是該事件指定的流。

返回值

將用於交換媒體資料的 RTCRtpTransceiver 物件。

異常

TypeError

如果 trackOrKind 既不是 "audio" 也不是 "video"，則會丟擲此異常。

如果使用了 sendEncodings 引數，並且存在格式錯誤的 rid 成員，或部分編碼包含 rid 成員，或不同編碼具有相同的 rid 值，則也可能丟擲此異常。

RangeError

如果 sendEncodings 的任何編碼具有小於 0.0 的 maxFramerate 值，或小於 1.0 的 scaleResolutionDownBy 值，則會丟擲此異常。

InvalidStateError DOMException

如果關聯的連線已關閉時呼叫該方法，則會丟擲此異常。

InvalidAccessError DOMException

如果使用了 sendEncodings 引數，並且它包含除 rid 以外的只讀引數，則會丟擲此異常。

規範

瀏覽器相容性

另見

• WebRTC API
• 即時傳輸協議 (RTP) 簡介
• RTCPeerConnection.addTrack() 也會建立收發器。
• RTCRtpReceiver 和 RTCRtpSender