RTCPeerConnection：remoteDescription 属性

remoteDescription 是 RTCPeerConnection 接口的只读属性，它返回一个 RTCSessionDescription，描述连接远程端会话（包括配置和媒体信息）。如果尚未设置，则为 null。

返回值通常反映从信令服务器接收到的远程描述（作为 offer 或 answer），然后由您的代码调用 RTCPeerConnection.setRemoteDescription() 以进行响应。

语法

js
const sessionDescription = peerConnection.remoteDescription

在更基本的层面上，如果该属性不为 null，则返回值为 RTCPeerConnection.pendingRemoteDescription 的值；否则，返回 RTCPeerConnection.currentRemoteDescription 的值。有关此算法及其使用原因的详细信息，请参阅 WebRTC 连接性页面中的 挂起和当前描述。

示例

此示例查看 remoteDescription 并显示一个警报，其中包含 RTCSessionDescription 对象的 type 和 sdp 字段。

js
const pc = new RTCPeerConnection();
// ...
const sd = pc.remoteDescription;
if (sd) {
  alert(`Remote session: type='${sd.type}'; sdp description='${sd.sdp}'`);
} else {
  alert("No remote session yet.");
}

规范

规范
WebRTC：浏览器中的实时通信
# dom-peerconnection-remotedescription

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅