RTCSessionDescription()

在此页

句法
范例
规范
浏览器兼容性
另请参阅
相关话题

这是实验性技术
检查浏览器兼容性表格要小心谨慎在生产中使用这之前。

弃用
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the 兼容性表格 at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.

RTCSessionDescription() 构造函数创建新 RTCSessionDescription with its properties initialized as described in the specified object.

This constructor has been deprecated because RTCPeerConnection.setLocalDescription() and other methods which take SDP as input now directly accept an object conforming to the RTCSessionDescriptionInit dictionary, so you don't have to instantiate an RTCSessionDescription yourself.

句法

 sessionDescription = new RTCSessionDescription(rtcSessionDescriptionInit);

值

rtcSessionDescriptionInit 可选

An object providing the default values for the session description; the object conforms to the


								RTCSessionDescriptionInit

dictionary. That dictionary has the following properties:

type

Required . A string which is a member of the


										RTCSdpType

enum; it must have one of the following values:

This enum defines strings that describe the current state of the session description, as used in the type property. The session description's type will be specified using one of these values.

值	描述
`answer`	The SDP contained in the `sdp` property is the definitive choice in the exchange. In other words, this session description describes the agreed-upon configuration, and is being sent to finalize negotiation.
`offer`	The session description object describes the initial proposal in an offer/answer exchange. The session negotiation process begins with an offer being sent from the caller to the callee.
`pranswer`	The session description object describes a provisional answer; that is, a response to a previous offer that is not the final answer. It is usually employed by legacy hardware.
`rollback`	This special type with an empty session description is used to roll back to the previous stable state.

sdp

A string containing a SDP message describing the session. This value is an empty string (

""

) by default and may not be


										null

范例

This example uses the constructor to convert an SDP offer into an RTCSessionDescription 对象。

This is no longer necessary, however; RTCPeerConnection.setLocalDescription() and other methods which take SDP as input now directly accept an object conforming to the RTCSessionDescriptionInit dictionary, so you don't have to instantiate an RTCSessionDescription yourself.

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

规范

规范	状态	注释
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCSessionDescription()' in that specification.	候选推荐	最初的规范。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`RTCSessionDescription()` 构造函数弃用	Chrome Yes	Edge ≤18	Firefox Yes Prefixed Yes Prefixed Prefixed Implemented with the vendor prefix: moz	IE No	Opera ?	Safari ?	WebView Android Yes	Chrome Android Yes	Firefox Android ?	Opera Android ?	Safari iOS ?	Samsung Internet Android Yes

图例

完整支持
不支持
兼容性未知 ?
实验。期望将来行为有所改变。
弃用。不要用于新网站。
要求使用供应商前缀或不同名称。

另请参阅

元数据

最后修改： 2019 年 3 月 23 日

在此页

句法

值

范例

规范

浏览器兼容性

图例

另请参阅

相关话题