RTCIceTransport：getRemoteCandidates() 方法

getRemoteCandidates() 是 RTCIceTransport 接口的方法，它返回一个数组，该数组包含在当前 ICE 收集会话期间迄今为止从远程对等体接收到的每个候选者的一个 RTCIceCandidate。

每次你的信令代码调用 RTCPeerConnection.addIceCandidate() 将接收到的候选者添加到 ICE 会话时，ICE 代理会将其放入此函数返回的列表中。

语法

js
getRemoteCandidates()

参数

无。

返回值

一个数组，包含在当前 ICE 候选者收集会话期间迄今为止从远程对等体接收到的每个候选者的一个 RTCIceCandidate 对象。

务必记住，无法将这些远程候选者与兼容的本地候选者关联起来。若要查找迄今为止找到的最佳匹配，请调用 RTCIceTransport.getSelectedCandidatePair()。

示例

此简单示例从 RTCIceTransport（针对 RTCPeerConnection 上的第一个 RTCRtpSender）获取远程候选者列表，然后将列表中的所有候选者输出到控制台。

js
const remoteCandidates = pc
  .getSenders()[0]
  .transport.transport.getRemoteCandidates();

remoteCandidates.forEach((candidate, index) => {
  console.log(`Candidate ${index}: ${candidate.candidate}`);
});

规范

规范
WebRTC：浏览器中的实时通信
# dom-rtcicetransport-getremotecandidates

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。