RTCPeerConnection: свойство currentLocalDescription

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

Чтобы изменить currentLocalDescription, вызовите RTCPeerConnection.setLocalDescription(), что запускает серию событий, которые приводят к установке этого значения. Более подробная информация о том, что именно происходит и почему изменение не происходит мгновенно, представлена на странице ВебRTC Соединение в разделе «Ожидаемые и текущие описания» (Pending and current descriptions).

Текущее описание локального конца соединения, если оно было установлено. Если оно не было успешно установлено, это значение равно null.

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

const pc = new RTCPeerConnection();
// ...
const sd = pc.currentLocalDescription;
if (sd) {
  alert(`Local session: type='${sd.type}'; sdp description='${sd.sdp}'`);
} else {
  alert("No local session yet.");
}

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