RTCPeerConnection.currentRemoteDescription

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Только для чтения свойство RTCPeerConnection.currentRemoteDescription возвращает объект RTCSessionDescription , представляющий удалённую сторону соединения, как последний, успешно согласованный объект данных, с момента завершения согласования и установки соединения объектом RTCPeerConnection с удалённым пиром.

Для изменения значения свойства currentRemoteDescription, вызовите метод RTCPeerConnection.setRemoteDescription(), который запускает серию событий, приводящих к установке нового значения. Подробнее о том, что точно происходит и почему изменение значения не происходит немедленно, смотрите Ожидающие и текущие объекты описания.

Примечание: В отличии от RTCPeerConnection.remoteDescription, это значение действительный текущий статус соединения; remoteDescription может указывать на объект описания, на который соединение находиться в процессе перехода..

Синтаксис

sessionDescription = RTCPeerConnection.currentRemoteDescription;

Возвращаемое значение

Текущий объект описания, представляющий удалённую сторону соединения, если она присутствует. Если ни один объект описания не установлен, значением будет null.

Пример

Пример рассматривает свойство currentRemoteDescription и отображает предупреждение, содержащее значения свойств type и sdp ,объекта RTCSessionDescription.

js
var pc = new RTCPeerConnection();var sd = pc.currentRemoteDescription;
if (sd) {
  alert("Local session: type='" +
        sd.type + "'; sdp description='" +
        sd.sdp + "'");
}
else {
  alert("No local session yet.");
}

Спецификации

Specification
WebRTC: Real-Time Communication in Browsers
# dom-peerconnection-currentremotedesc

Совместимость с браузерами

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
currentRemoteDescription

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Смотрите также