RTCSessionDescription()

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.

The RTCSessionDescription() constructor creates a new RTCSessionDescription.

Syntax

 sessionDescription = new RTCSessionDescription(rtcSessionDescriptionInit);

Values

rtcSessionDescriptionInit Optional
Is a RTCSessionDescriptionInit dictionary, having the following fields:
  • "type", optional and defaulting to null, of type RTCSdpType, that is "offer", "answer" or "pranswer".
  • "sdp", optional and defaulting to null, of type DOMString and containing a SDP message describing the session.

Example

navigator.getUserMedia({video: true}, function(stream) {
  pc.onaddstream({stream: stream});
  // Adding a local stream won't trigger the onaddstream callback
  pc.addStream(stream);

  pc.createOffer(function(offer) {
    pc.setLocalDescription(new RTCSessionDescription(offer), function() {
      // send the offer to a server to be forwarded to the friend you're calling.
    }, error);
  }, error);
}

Specifications

Specification Status Comment
WebRTC 1.0: Real-time Communication Between Browser
The definition of 'RTCSessionDescription()' in that specification.
Working Draft Initial specification.

[1] Though this property is not prefixed, the interface it belongs to is.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) [1] Not supported (Yes) ?
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? ? ? Not supported ? ?

See also

Document Tags and Contributors

 Contributors to this page: teoli
 Last updated by: teoli,