RTCPeerConnection:currentRemoteDescription 属性

currentRemoteDescriptionRTCPeerConnection 接口的只读属性,它返回一个 RTCSessionDescription 对象,该对象描述了自上次 RTCPeerConnection 完成协商并连接到远程对等点后,最近一次成功协商的连接的远程端。还包括自描述所表示的 offer 或 answer 首次实例化以来,ICE 代理可能已生成的任何 ICE 候选者的列表。

要更改 currentRemoteDescription,请调用 RTCPeerConnection.setRemoteDescription(),这将触发一系列事件,从而导致此值被设置。有关确切发生的情况以及更改为何不一定是即时的详细信息,请参阅 WebRTC 连接页面中的 挂起描述和当前描述

注意:RTCPeerConnection.remoteDescription 不同,此值表示连接本地端的实际当前状态;remoteDescription 可能指定连接当前正在切换到的描述。

如果已设置,则为连接远程端的当前描述。如果尚未成功设置,则此值为 null

示例

此示例查看 currentRemoteDescription 并显示一个包含 RTCSessionDescription 对象的 typesdp 字段的警报。

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 的浏览器中加载。

另请参阅