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

RTCPeerConnection.canTrickleIceCandidates

· 52CE 我爱测

只读的 **RTCPeerConnection** 属性 `canTrickleIceCandidates` 返回一个Boolean,它指示远程对等端是否可以接受 trickled ICE candidates 。

WebRTC

只读的 RTCPeerConnection 属性 canTrickleIceCandidates 返回一个Boolean,它指示远程对等端是否可以接受 trickled ICE candidates 。

ICE trickling是在初始发送或回应已经发送给其他设备之后继续发送候选的过程。

仅在调用RTCPeerConnection.setRemoteDescription()之后才设置此属性。理想情况下,你的信令协议提供了一种检测涓流支持的方法,因此你无需依赖此属性。WebRTC 浏览器将始终支持 trickle ICE。如果不支持涓流,或者你无法辨别,则可以检查此属性的伪值,然后等待RTCPeerConnection.iceGatheringState的值更改在创建和发送之前“完成”。这样,发送信息包含所有候选。

值

Boolean 如果远程对等方可以接受涓流 ICE 候选,则为 true;如果不能,则为 false。如果尚未建立远程对等方,则此值为 null。

[!NOTE] 一旦本地对等方调用 RTCPeerConnection.setRemoteDescription(),就确定该属性的值;ICE 代理使用所提供的描述来确定远程对等方是否支持涓流 ICE 候选。

示例

var pc = new RTCPeerConnection();
// The following code might be used to handle an offer from a peer when
// it isn't known whether it supports trickle ICE.
pc.setRemoteDescription(remoteOffer)
  .then(_ => pc.createAnswer())
  .then(answer => pc.setLocalDescription(answer))
  .then(_ =>
    if (pc.canTrickleIceCandidates) {
      return pc.localDescription;
    }
    return new Promise(r => {
      pc.addEventListener('icegatheringstatechange', e => {
        if (e.target.iceGatheringState === 'complete') {
          r(pc.localDescription);
        }
      });
    });
  })
  .then(answer => sendAnswerToPeer(answer)) // signaling message
  .catch(e => handleError(e));

pc.addEventListener('icecandidate', e => {
  if (pc.canTrickleIceCandidates) {
    sendCandidateToPeer(e.candidate); // signaling message
  }
});

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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