RTCPeerConnection: currentRemoteDescription 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流浏览器均已支持。

RTCPeerConnection 接口的只读属性 currentRemoteDescription 返回一个 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

浏览器兼容性

另见