在此页

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

RTCIceTransport 方法 getLocalCandidates() returns an array of RTCIceCandidate objects, one for each of the candidates that have been gathered by the local device during the current ICE agent session.

The local candidates are placed in this list by the ICE agent prior to being delivered to the local client's code in an icecandidate event so that the client can forward the candidates to the remote peer.

句法

localCandidates = RTCIceTransport.getLocalCandidates();
					

参数

None.

返回值

A JavaScript 数组 containing one RTCIceCandidate object for each candidate that has been identified so far during the ICE candidate gathering session.

You can't correlate these local candidates with matching remote candidates. To find the best match found so far, call RTCIceTransport.getSelectedCandidatePair() .

范例

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

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

规范

规范	状态	注释
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCIceCandidate.getLocalCandidates()' 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
getLocalCandidates	Chrome 不支持 No	Edge 不支持 No	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