在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 相关话题

RTCIceTransport 方法 getRemoteCandidates() returns an array which contains one RTCIceCandidate for each of the candidates that have been received from the remote peer so far during the current ICE gathering session.

Each time your signaling code calls RTCPeerConnection.addIceCandidate() to add a received candidate to the ICE session, the ICE agent places it in the list returned by this function.

句法

remoteCandidates = RTCIceTransport.getRemoteCandidates();
					

参数

None.

返回值

An array containing one RTCIceCandidate object for each candidate that has been received so far from the remote peer during the current ICE candidate gathering session.

It's important to keep in mind that there's no way to correlate these remote candidates with compatible local candidates. To find the best match found so far, call RTCIceTransport.getSelectedCandidatePair() .

范例

This simple example gets the remote candidate list from the RTCIceTransport for the first RTCRtpSender 在 RTCPeerConnection , then outputs to the console all of the candidates in the list.

var remoteCandidates = pc.getSenders()[0].transport.transport.getRemoteCandidates();
remoteCandidates.forEach(function(candidate, index)) {
  console.log("Candidate " + index + ": " + candidate.candidate);
});
					

规范

规范	状态	注释
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCIceCandidate.getRemoteCandidates()' in that specification.	候选推荐	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
getRemoteCandidates	Chrome 不支持 No	Edge 不支持 15 — 79	Firefox 不支持 No	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 不支持 No	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No

图例

不支持

不支持

元数据

• 最后修改： Mar 18, 2019

相关话题

1. WebRTC API
2. RTCIceTransport
3. 特性

   1. component
   2. gatheringState
   3. getRemoteCandidates()
   4. ongatheringstatechange
   5. onselectedcandidatepairchange
   6. onstatechange
   7. role
   8. state
4. 方法

   1. getLocalCandidates()
   2. getLocalParameters()
   3. getSelectedCandidatePair()
5. Related pages for WebRTC

   1. MediaDevices.getUserMedia()
   2. Navigator.mediaDevices
   3. RTCCertificate
   4. RTCDTMFSender
   5. RTCDTMFToneChangeEvent
   6. RTCDataChannel
   7. RTCDataChannelEvent
   8. RTCDtlsTransport
   9. RTCErrorEvent
   10. RTCIceCandidate
   11. RTCPeerConnection
   12. RTCPeerConnectionIceErrorEvent
   13. RTCPeerConnectionIceEvent
   14. RTCRtpReceiver
   15. RTCRtpSender
   16. RTCRtpTransceiver
   17. RTCSctpTransport
   18. RTCSessionDescription
   19. RTCStatsEvent
   20. RTCStatsReport
   21. RTCTrackEvent