The RTCPeerConnection method addTransceiver() 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.
RTCPeerConnection.addTransceiver()
Syntax
addTransceiver(trackOrKind) addTransceiver(trackOrKind, init)
Parameters
-
trackOrKind -
A
MediaStreamTrackto associate with the transceiver, or a string which is used as thekindof the receiver'strack, and by extension of theRTCRtpReceiveritself. -
initOptional -
An object for specifying any options when creating the new transceiver. Possible values are:
-
directionOptional -
The new transceiver's preferred directionality. This value is used to initialize the new
RTCRtpTransceiverobject'sRTCRtpTransceiver.directionproperty. -
sendEncodingsOptional -
A list of encodings to allow when sending RTP media from the
RTCRtpSender. Each entry is of typeRTCRtpEncodingParameters. -
streamsOptional -
A list of
MediaStreamobjects to add to the transceiver'sRTCRtpReceiver; when the remote peer'sRTCPeerConnection'strackevent occurs, these are the streams that will be specified by that event.
-
Exceptions
-
TypeError -
A string was specified as
trackOrKindwhich is not valid. The string must be either"audio"or"video".
Specifications
| Specification |
|---|
| WebRTC 1.0: Real-Time Communication Between Browsers # dom-rtcpeerconnection-addtransceiver |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
addTransceiver |
69
|
79
|
59
|
No
|
No
|
11
|
69
|
69
|
59
|
No
|
11
|
10.0
|
init_direction_parameter |
69
|
79
|
59
|
No
|
No
|
11
|
69
|
69
|
59
|
No
|
11
|
10.0
|
init_sendEncodings_parameter |
69
|
79
|
No
sendEncodings is not yet implemented in Firefox. See
bug 1396918.
|
No
|
No
|
14.1
|
69
|
69
|
No
sendEncodings is not yet implemented in Firefox. See
bug 1396918.
|
No
|
14.5
|
10.0
|
init_streams_parameter |
69
|
79
|
59
|
No
|
No
|
12.1
|
69
|
69
|
59
|
No
|
12.2
|
10.0
|
See also
- WebRTC API
- Introduction to the Real-time Transport Protocol (RTP)
-
RTCPeerConnection.addTrack()also creates transceivers -
RTCRtpReceiverandRTCRtpSender
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/addTransceiver
