RTCIceCandidate: свойство priority

Только для чтения priority свойство интерфейса RTCIceCandidate указывает приоритет кандидата в соответствии с удалённым узлом; чем выше это значение, тем лучше удалённый узел рассматривает кандидата.

Значение поля priority устанавливается из объекта candidateInfo options, переданного конструктору RTCIceCandidate(). Вы не можете указать значение priority напрямую в объекте options, но его значение автоматически извлекается из атрибута candidate a-строки, если он отформатирован должным образом.

Целое значение без знака, указывающее приоритет кандидата в соответствии с удалённым узлом. Чем больше это значение, тем предпочтительнее этот кандидат для удалённого узла.

priority инициализируется значением null, если оно не указано в candidate, или если строка candidate не может быть обработана должным образом.

Рассмотрим строку атрибута SDP (a-строку), описывающую кандидата ICE:

a=candidate:4234997325 1 udp 2043278322 192.0.2.172 44323 typ host

Приоритет — это число после протокола, поэтому это четвёртое поле в строке кандидата. В этом примере приоритет равен 2043278322.

Этот кандидат проверяет priority кандидата и, если он больше приоритета ранее увиденного кандидата, запоминает кандидата для последующего использования.

let bestCandidate = {
  candidate: "",
  sdpMid: null,
  sdpMLineIndex: null,
  priority: 0,
};

function handleCandidate(candidateString) {
  const candidate = new RTCIceCandidate(candidateString);

  if (candidate.priority > bestCandidate.priority) {
    bestCandidate = candidate;
  }
}