Spec-Zone.ru › Web APIs

RTCPeerConnection: свойство currentRemoteDescription

Базовая Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с января 2020 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

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

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

Примечание: В отличие от RTCPeerConnection.remoteDescription, это значение представляет фактическое текущее состояние локального конца соединения; remoteDescription может указать описание, к которому соединение в настоящее время переключается.

Значение

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

Примеры

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

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

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

Спецификация
WebRTC: Взаимодействие в режиме реального времени в браузерах
# dom-peerconnection-currentremotedesc

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

Рабочий стол Мобильный
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
currentRemoteDescription 70 79 57 57 11 70 57 49 11 10.0 70

См. также

  • RTCPeerConnection.setRemoteDescription(), RTCPeerConnection.pendingRemoteDescription, RTCPeerConnection.remoteDescription
  • RTCPeerConnection.setRemoteDescription(), RTCPeerConnection.remoteDescription, RTCPeerConnection.pendingRemoteDescription
  • WebRTC

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/currentRemoteDescription

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API