在此页

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

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

The read-only property RTCPeerConnection.localDescription 返回 RTCSessionDescription describing the session for the local end of the connection. If it has not yet been set, this is null .

句法

 var sessionDescription = peerConnection.localDescription;
					

On a more fundamental level, the returned value is the value of RTCPeerConnection.pendingLocalDescription if that property isn't null ; otherwise, the value of RTCPeerConnection.currentLocalDescription is returned. See Pending and current descriptions in WebRTC connectivity for details on this algorithm and why it's used.

范例

This example looks at the localDescription and displays an alert containing the RTCSessionDescription 对象的 type and sdp 字段。

var pc = new RTCPeerConnection();
…
var sd = pc.localDescription;
if (sd) {
  alert("Local session: type='" +
        sd.type + "'; sdp description='" +
        sd.sdp + "'");
}
else {
  alert("No local session yet.");
}
					

规范

规范	状态	注释
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCPeerConnection.localDescription' 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
localDescription	Chrome 24	Edge 15	Firefox 22	IE No	Opera 43 43 Promise-based version. 不支持 37 — 43	Safari 11	WebView Android Yes	Chrome Android 25	Firefox Android 44	Opera Android 43 43 Promise-based version. 不支持 37 — 43	Safari iOS Yes	Samsung Internet Android 6.0

图例

完整支持

完整支持

不支持

不支持

见实现注意事项。

另请参阅

• RTCPeerConnection.setLocalDescription() , RTCPeerConnection.pendingLocalDescription , RTCPeerConnection.currentLocalDescription
• RTCPeerConnection.setRemoteDescription() , RTCPeerConnection.remoteDescription , RTCPeerConnection.pendingRemoteDescription , RTCPeerConnection.currentRemoteDescription
• WebRTC

元数据

• 最后修改： 2020 年 1 月 22 日

相关话题

1. WebRTC API
2. WebRTC Guides

   1. WebRTC Architecture
   2. WebRTC Basics
   3. WebRTC Protocols
   4. Dealing with connectivity
   5. Overview of WebRTC interfaces
   6. Lifetime of a WebRTC Session
   7. Using data channels
3. WebRTC Tutorials

   1. Interoperability with adapter.js
   2. Taking still photos from the camera
   3. A simple data channel example
4. 接口

   1. RTCPeerConnection
   2. RTCSessionDescription
   3. RTCIceCandidate
   4. RTCPeerConnectionIceEvent
   5. MessageEvent
   6. MediaStream
   7. RTCStatsReport
   8. RTCIdentityEvent
   9. RTCIdentityErrorEvent
   10. MediaStreamEvent
   11. MediaStreamTrack
   12. MediaDevices
5. 文档编制：
6. 有用清单

   1. Pages tagged "WebRTC"
7. 贡献

   1. WebRTC doc status
   2. MDN 工程