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