RTCIceTransport: getSelectedCandidatePair() 方法
getSelectedCandidatePair()
是 RTCIceTransport
接口的方法,它返回一个 RTCIceCandidatePair
对象,其中包含当前最佳选择的 ICE 候选对,描述传输端点的配置。
语法
js
getSelectedCandidatePair()
参数
无。
返回值
一个 RTCIceCandidatePair
对象,描述当前选定候选对的两个端点的配置。 local
描述连接本地端的配置,而 remote
描述远程对等体的配置。
如果还没有选择候选对,则返回值为 null
。
使用说明
当 ICE 代理执行 RTCPeerConnection
的协商时,它会收集和分析来自两个对等体的候选配置。一旦它找到满足连接要求的可接受匹配候选对,就会在 RTCIceTransport
上触发 selectedcandidatepairchange
事件。从那时起,通过调用 getSelectedCandidatePair()
始终可以获取最佳匹配的候选对。
随着 ICE 协商继续,如果发现任何候选对比当前选定对更好,就会选择新的对,替换之前的配对,并且再次触发 selectedcandidatepairchange
事件。
注意: 当选择新的配对时,选定候选对中的一个配置可能保持不变。
示例
有关示例代码,请参见 RTCIceTransport.onselectedcandidatepairchange
。
规范
规范 |
---|
WebRTC:浏览器中的实时通信 # dom-rtcicetransport-getselectedcandidatepair |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。