Share via


RTCPeerConnection object

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

The RTCPeerConnection object is used to represent a connection between a local device and a remote peer.

Syntax

 var peerConnection = new RTCPeerConnection(configuration); 

Members

The RTCPeerConnection object has these types of members:

  • Events
  • Methods
  • Properties

Events

The RTCPeerConnection object has these events.

Event Description
onaddstream

This event fires when a new MediaStream object is added to the RTCPeerConnection.

onicecandidate

This event fires when a new RTCIceCandidate object is made available.

oniceconnectionstatechange

This event fires when the iceConnectionState of the RTCPeerConnection has changed.

onicegatheringstatechange

This event fires when the iceGatheringState of the RTCPeerConnection has changed.

onnegotiationneeded

This event fires any time the browser wants to inform the application that session negotiation needs to be done.

onremovestream

This event fires when a MediaStream object is removed from the RTCPeerConnection.

onsignalingstatechange

This event fires when the signaling state has changed.

 

Methods

The RTCPeerConnection object has these methods.

Method Description
addIceCandidate

The addIceCandidate method adds an ice candidate to an ICE agent.

addStream

The addStream method takes a MediaStream and adds it as a local source to an RTCPeerConnection object.

close

The close method closes the current peer connection.

createAnswer

The createAnswer method creates an answer once an offer from a remote peer has been received.

createOffer

The createOffer method creates an SDP offer.

getConfiguration

The getConfiguration method returns an RTCConfiguration object that has the current configuration values of the RTCPeerConnection object.

getLocalStreams

The getLocalStreams method returns a sequenced array of MediaStreams that are associated with the local end of the connection.

getRemoteStreams

The getRemoteStreams method returns a sequenced array of MediaStreams that are associated with the remote end of the connection.

getStats

The getStats method gathers stats of the RTCPeerConnection and reports the result asynchronously.

getStreamById

The getStreamById method takes an ID and returns the MediaStream with that ID associated with the local or remote end of the connection.

removeStream

The removeStream method takes a MediaStream and removes it as a local source from an RTCPeerConnection object.

setLocalDescription

The setLocalDescription method updates the local description of the connection.

setRemoteDescription

The setRemoteDescription method updates the remote description of the connection.

 

Properties

The RTCPeerConnection object has these properties.

Property Access type Description

canTrickleIceCandidates

Read-only

The canTrickleIceCandidates property indicates whether the remote peer can accept trickled ICE candidates.

iceConnectionState

Read-only

The iceConnectionState property indicates whether the remote peer can accept trickled ICE candidates.

iceGatheringState

Read-only

The iceGatheringState property describes the connections gathering state.

localDescription

Read-only

The localDescription property represents the description of the local end of the connection.

remoteDescription

Read-only

The remoteDescription property represents the description of the remote end of the connection.

signalingState

Read-only

The signalingState property describes the state of the signaling process for the local end of the connection.

 

Remarks

The RTCPeerConnection constructor includes the following parameters:

Parameter Type Description
configuration RTCConfiguration Provides changes to be made to the connection configuration.