大网数据广告活动
Web 标准与前端开发

RTCPeerConnection: addTransceiver() method

· 52CE 我爱测

The **`addTransceiver()`** method of the RTCPeerConnection interface creates a new RTCRtpTransceiver and adds it to the set of transceivers associated with the `RTCPeerConnection`. Each transceiver represents a bidirectional stream, with both an RTCRtpSender and an RTCRtpReceiver

WebRTC

The addTransceiver() method of the RTCPeerConnection interface creates a new RTCRtpTransceiver and adds it to the set of transceivers associated with the RTCPeerConnection. Each transceiver represents a bidirectional stream, with both an RTCRtpSender and an RTCRtpReceiver associated with it.

Syntax

addTransceiver(trackOrKind)
addTransceiver(trackOrKind, init)

Parameters

  • trackOrKind
    • : A MediaStreamTrack to associate with the transceiver, or a string which is used as the MediaStreamTrack.kind of the receiver's RTCRtpReceiver.track, and by extension of the RTCRtpReceiver itself.
  • init
    • : An object for specifying any options when creating the new transceiver. Possible values are:
      • direction
        • : The new transceiver's preferred directionality. This value is used to initialize the new RTCRtpTransceiver object's RTCRtpTransceiver.direction property.
      • sendEncodings
        • : An array of encodings to allow when sending RTP media from the RTCRtpSender. This is the same as the parameter.encodings array passed to RTCRtpSender.setParameters().
      • streams
        • : A list of MediaStream objects to add to the transceiver's RTCRtpReceiver; when the remote peer's RTCPeerConnection's RTCPeerConnection.track_event event occurs, these are the streams that will be specified by that event.

Return value

The RTCRtpTransceiver object which will be used to exchange the media data.

Exceptions

  • TypeError

    • : Thrown if trackOrKind was not either "audio" or "video".

      If the sendEncodings argument is used, this error may also be thrown if there is a badly formatted rid member, some but not all encodings contain a rid member, or different encodings have the same rid value.

  • RangeError

    • : Thrown if any of the sendEncodings encodings have a maxFramerate value less than 0.0, or a scaleResolutionDownBy value of less than 1.0.
  • InvalidStateError DOMException

    • : Thrown if the method is called when the associated connection is closed.
  • InvalidAccessError DOMException

    • : Thrown if the sendEncodings argument is used, and contains a read-only parameter other than rid.

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。