RTCPeerConnection: remoteDescription 属性
RTCPeerConnection 接口的只读属性 remoteDescription 返回一个 RTCSessionDescription 对象,该对象描述了连接的远程端的会话(包括配置和媒体信息)。如果尚未设置,则此属性为 null。
返回的值通常反映了通过信令服务器接收到的远程描述(作为 offer 或 answer),然后通过您的代码响应式地调用 RTCPeerConnection.setRemoteDescription() 来生效。
值
更根本地说,返回值是 RTCPeerConnection.pendingRemoteDescription 的值(如果该属性不为 null);否则,将返回 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 |
浏览器兼容性
加载中…