RTCIceCandidate: priority property

Value

A long, unsigned integer value indicating the priority of the candidate according to the remote peer. The larger this value is, the more preferable the remote peer considers this candidate to be.

priority is initialized to null if it is not specified in the candidate, or if the candidate string can't be parsed properly.

Usage notes

Consider this SDP attribute line (a-line) which describes an ICE candidate:

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

The priority is the number after the protocol, so it's the fourth field in the candidate string. In this example, the priority is 2043278322.

Examples

This candidate examines the priority of the candidate and, if it's greater than the priority of a previously-seen candidate, remembers the candidate for later use.

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

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

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

Specifications

Browser compatibility