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

RTCIceCandidate:candidate 属性

· 52CE 我爱测

RTCIceCandidate** 接口的 **`candidate`** 只读属性返回一个详细描述候选者的字符串。`RTCIceCandidate` 的大多数其他属性实际上都是从这个字符串中提取的。

WebRTC

RTCIceCandidate 接口的 candidate 只读属性返回一个详细描述候选者的字符串。RTCIceCandidate 的大多数其他属性实际上都是从这个字符串中提取的。

可以使用传递给 RTCIceCandidate.RTCIceCandidate 构造函数或 RTCPeerConnection.addIceCandidate() 对象的 candidate 属性来配置此属性。

值

直接从 SDP 属性 "candidate" 中获取的一个描述候选者属性的字符串。候选者字符串指定了候选者的网络连接信息。如果 candidate 是一个空字符串(""),则已经到达了候选列表的末尾;这个候选者被称为 "end-of-candidates"(候选结束)标记。候选者字符串的语法在 中描述。假设一个属性行内容如下:

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

相应的 candidate 字符串的值将是:"candidate:4234997325 1 udp 2043278322 192.0.2.172 44323 typ host"。其他条件相同时,user agent将选择具有最高RTCIceCandidate.priority的候选者。在上面的示例中,优先级为 2043278322。每个候选者属性都用单个空格字符分隔,并且按特定顺序排列。此示例候选者的属性完整列表为:

  • RTCIceCandidate.foundation = 4234997325
  • RTCIceCandidate.component = "rtp"(数字 1 将会编码为 "rtp" 字符串;数字 2 则是 "rtcp")
  • RTCIceCandidate.protocol = "udp"
  • RTCIceCandidate.priority = 2043278322
  • RTCIceCandidate/address = "192.0.2.172"
  • RTCIceCandidate.port = 44323
  • RTCIceCandidate.type = "host"

示例

在下面这个例子中,我们看到函数接收一个 ICE 候选者的 SDP 字符串作为参数输入,该字符串是在信令过程中从远程对等端接收到的。

function handleNewIceCandidate(candidateSDP) {
  const candidateObj = new RTCIceCandidate(candidateSDP);

  myPeerConnection
    .addIceCandidate(candidateObj)
    .catch({/* 处理 addIceCandidate() 引发的错误 */});
}

函数 handleNewIceCandidate() 将接收到的候选者的 SDP 文本传递给 RTCIceCandidate.RTCIceCandidate 构造函数,以获得一个表示该候选者的 RTCIceCandidate 实例。然后将新候选者实例传递给 RTCPeerConnection.addIceCandidate() 方法,将候选者添加到 WebRTC 建立连接时要考虑使用的候选者列表中。

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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