WebRTC
The RTCSessionDescription() constructor creates a new
RTCSessionDescription with its properties initialized as described in the
specified object.
[!NOTE] This constructor has been deprecated because RTCPeerConnection.setLocalDescription() and other methods which take SDP as input now directly accept an object containing the RTCSessionDescription.type and RTCSessionDescription.sdp properties, so you don't have to instantiate an
RTCSessionDescriptionyourself.
Syntax
new RTCSessionDescription(options)
Values
options- : An object providing the default values for the session description. It should contain the following properties:
type- : Required. A string which is used to set the
typeproperty of the newRTCSessionDescriptionobject. Must be one of the valid RTCSessionDescription.type values.
- : Required. A string which is used to set the
sdp- : A string containing a SDP message describing the session. This value is an empty string (
"") by default and may not benull.
- : A string containing a SDP message describing the session. This value is an empty string (
- : An object providing the default values for the session description. It should contain the following properties:
Example
This example uses the constructor to convert an SDP offer into an
RTCSessionDescription object.
[!NOTE] This is no longer necessary, however; RTCPeerConnection.setLocalDescription() and other methods which take SDP as input now directly accept plain objects, so you don't have to instantiate an
RTCSessionDescriptionyourself.
navigator.getUserMedia({ video: true }, (stream) => {
pc.onaddstream({ stream });
// Adding a local stream won't trigger the onaddstream callback
pc.addStream(stream);
pc.createOffer((offer) => {
pc.setLocalDescription(
new RTCSessionDescription(offer),
() => {
// send the offer to a server to be forwarded to the friend you're calling.
},
error,
);
}, error);
});
Specifications
Browser compatibility
See also
- WebRTC API
- RTCSessionDescription
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
