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.


rtpTransceiver = RTCPeerConnection.addTransceiver(trackOrKind, init);


A MediaStreamTrack to associate with the transceiver, or a DOMString which is used as the kind of the receiver's track, and by extension of the RTCRtpReceiver itself.
init Optional
An object that conforms to the RTCRtpTransceiverInit dictionary which provides any options that you may wish to specify when creating the new transceiver. Possible values are:
direction Optional
The new transceiver's preferred directionality. This value is used to initialize the new RTCRtpTransceiver object's RTCRtpTransceiver.direction property.
sendEncodings Optional
A list of encodings to allow when sending RTP media from the RTCRtpSender. Each entry is of type RTCRtpEncodingParameters.
streams Optional
A list of MediaStream objects to add to the transceiver'sRTCRtpReceiver; when the remote peer's RTCPeerConnection's track event occurs, these are the streams that will be specified by that event.



A string was specified as trackOrKind which is not valid. The string must be either "audio" or "video".


Specification Status Comment
WebRTC 1.0: Real-time Communication Between Browsers
The definition of 'RTCPeerConnection.addTransceiver()' in that specification.
Candidate Recommendation  

Browser compatibility

Update compatibility data on GitHub
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
addTransceiverChrome Full support 69Edge Full support 79Firefox Full support 59IE No support NoOpera No support NoSafari Full support 11WebView Android Full support 69Chrome Android Full support 69Firefox Android Full support 59Opera Android No support NoSafari iOS Full support YesSamsung Internet Android Full support 10.0


Full support  
Full support
No support  
No support

See also