RTCPeerConnection:currentRemoteDescription 属性
currentRemoteDescription
是 RTCPeerConnection
接口的只读属性,它返回一个 RTCSessionDescription
对象,该对象描述了自上次 RTCPeerConnection
完成协商并连接到远程对等点后,最近一次成功协商的连接的远程端。还包括自描述所表示的 offer 或 answer 首次实例化以来,ICE 代理可能已生成的任何 ICE 候选者的列表。
要更改 currentRemoteDescription
,请调用 RTCPeerConnection.setRemoteDescription()
,这将触发一系列事件,从而导致此值被设置。有关确切发生的情况以及更改为何不一定是即时的详细信息,请参阅 WebRTC 连接页面中的 挂起描述和当前描述。
注意:与 RTCPeerConnection.remoteDescription
不同,此值表示连接本地端的实际当前状态;remoteDescription
可能指定连接当前正在切换到的描述。
值
如果已设置,则为连接远程端的当前描述。如果尚未成功设置,则此值为 null
。
示例
此示例查看 currentRemoteDescription
并显示一个包含 RTCSessionDescription
对象的 type
和 sdp
字段的警报。
js
const pc = new RTCPeerConnection();
// ...
const sd = pc.currentRemoteDescription;
if (sd) {
alert(`Local session: type='${sd.type}'; sdp description='${sd.sdp}'`);
} else {
alert("No local session yet.");
}
规范
规范 |
---|
WebRTC:浏览器中的实时通信 # dom-peerconnection-currentremotedesc |
浏览器兼容性
BCD 表格仅在启用了 JavaScript 的浏览器中加载。