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 的浏览器中加载。