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

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

BCD tables only load in the browser

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