大网数据广告活动
Web 标准与前端开发

RTCIceCandidate:priority 属性

· 52CE 我爱测

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

WebRTC

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

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

值

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

[!NOTE] 如果 priority 为 null,则将 candidate 传递给 RTCPeerConnection.addIceCandidate 将失败,抛出 OperationError 异常。只有当候选者实现 priority 属性时才适用此规则。

使用说明

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

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

优先级(priority)是协议("udp")后面的数字,所以它是候选者字符串中的第四个字段。在这个例子中,优先级是 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;
  }
}

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。