RTCIceCandidate：priority 属性

RTCIceCandidate 接口的 priority 只读属性指示由远程对等端确定的候选者的优先级。优先级的值越高，远程对等端认为候选者越好。

priority 字段的值是从传递给 RTCIceCandidate() 构造函数的 candidateInfo 选项对象中设置的。你不能直接在选项对象中指定 priority 的值，如果对象的 candidate 属性行（a-line）格式正确，其值将自动从对象的 candidate 属性行中提取。

值

一个无符号长整数值，指示由远程对等端确定的候选者的优先级。这个值越大，远程对等端认为这个候选者越可取。如果没有在 candidate（属性行）中指定 priority 或者 candidate 字符串不能被正确解析，该值则为 null。

备注： 如果 priority 为 null，则将 candidate 传递给 addIceCandidate() 将失败，抛出 OperationError 异常。只有当候选者实现 priority 属性时才适用此规则。

使用说明

考虑描述 ICE 候选者的 SDP 属性行如下：

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

优先级（priority）是协议（"udp"）后面的数字，所以它是候选者字符串中的第四个字段。在这个例子中，优先级是 2043278322。

示例

这个候选者检查候选者的优先级（priority），如果它比之前看到的候选者的优先级更高，就会记住候选者以供以后使用。

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

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

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

规范

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcicecandidate-priority

浏览器兼容性

BCD tables only load in the browser