Spec-Zone.ru › Web APIs

RTCIceTransport: метод getRemoteCandidates()

Метод getRemoteCandidates() интерфейса RTCIceTransport возвращает массив, содержащий по одному RTCIceCandidate для каждого кандидата, полученного от удалённого узла до настоящего момента во время текущей сессии сбора кандидатов ICE.

Каждый раз, когда ваш код сигнализации вызывает RTCPeerConnection.addIceCandidate() для добавления полученного кандидата в сессию ICE, агент ICE размещает его в списке, возвращаемом этой функцией.

Синтаксис

getRemoteCandidates()

Параметры

Нет.

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

Массив, содержащий по одному объекту RTCIceCandidate для каждого кандидата, полученного до настоящего момента от удалённого узла во время текущей сессии сбора кандидатов ICE.

Важно помнить, что нет способа сопоставить этих удалённых кандидатов с совместимыми локальными кандидатами. Чтобы найти наилучшее совпадение, используйте RTCIceTransport.getSelectedCandidatePair().

Пример

В этом простом примере извлекается список удалённых кандидатов из RTCIceTransport для первого RTCRtpSender на RTCPeerConnection, затем выводится в консоль список всех кандидатов.

const remoteCandidates = pc
  .getSenders()[0]
  .transport.transport.getRemoteCandidates();

remoteCandidates.forEach((candidate, index) => {
  console.log(`Candidate ${index}: ${candidate.candidate}`);
});

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

Спецификация
WebRTC: Реальное взаимодействие в браузерах
# dom-rtcicetransport-getremotecandidates

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на IOS Samsung Internet WebView Android
getRemoteCandidates 75 13 Нет 62 Нет 75 Нет 54 Нет 11.0 75

© 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/RTCIceTransport/getRemoteCandidates

Spec-Zone.ru

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