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.

SyntaxEdit

 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.

ExampleEdit

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);
}

SpecificationsEdit

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 compatibilityEdit

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

See alsoEdit

Document Tags and Contributors

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