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

浏览器兼容性