RTCPeerConnection: свойство remoteDescription

Свойство remoteDescription только для чтения интерфейса RTCPeerConnection возвращает объект RTCSessionDescription, описывающий сеанс (включая конфигурацию и информацию о медиа) для удалённого конца соединения. Если это свойство ещё не задано, оно null.

Возвращаемое значение обычно отражает удалённое описание, которое было получено через сервер сигнализации (как предложение или ответ) и затем применено кодом, вызвавшим RTCPeerConnection.setRemoteDescription() в ответ.

const sessionDescription = peerConnection.remoteDescription

На более фундаментальном уровне возвращаемое значение — это значение RTCPeerConnection.pendingRemoteDescription, если это свойство не null; в противном случае возвращается значение RTCPeerConnection.currentRemoteDescription. Подробнее об этом алгоритме и причинах его использования см. на странице WebRTC Connectivity в разделе «Ожидаемые и текущие описания» (Pending and current descriptions).

В этом примере рассматривается remoteDescription и отображается всплывающее окно с полями RTCSessionDescription объекта: type и sdp.

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.");
}

• RTCPeerConnection.setRemoteDescription(), RTCPeerConnection.pendingRemoteDescription, RTCPeerConnection.currentRemoteDescription
• RTCPeerConnection.setLocalDescription(), RTCPeerConnection.pendingLocalDescription, RTCPeerConnection.currentLocalDescription, RTCPeerConnection.localDescription
• WebRTC