RTCIceCandidatePairStats: state 属性

state 属性是一个字符串,指示候选对所属检查列表的状态。

一个字符串,其值为以下之一

failed

已对该对执行检查,但检查失败。失败可能由于未收到响应或响应指示发生不可恢复的错误。

frozen

尚未对该候选对执行任何检查,并且执行检查会被阻塞,直到另一个检查成功。一旦该检查成功,此对将解除冻结并进入 waiting 状态。

in-progress

已为该对启动检查,但检查的事务仍在进行中。

succeeded

已成功完成对该对的检查。

waiting

此对尚未进行检查,但一旦此对成为 waiting 状态中剩余的最高优先级对,就可以执行检查。

ICE 检查列表

在 ICE 协商期间,ICE 层构建了一个检查列表,它是一个 ICE 候选配对的潜在列表。每个对都有一个状态,用字符串文字表示。

A diagram showing how ICE candidate pairs change state as the checklist is analyzed

当候选对添加到检查列表时,它从 frozen 状态开始。一旦没有正在进行的检查阻止对被分析,它就会解冻并进入 waiting 状态。这可能在添加到检查列表后立即发生。

每次检查候选对时,检查列表中剩余的下一个最高优先级的候选对将从 waiting 状态变为 in-progress 状态,并开始其检查。如果检查由于任何原因失败,则该对将进入其最终状态 failed。如果检查成功,则该对将进入 succeeded 状态。可以在相应的 state 属性中找到任何给定的 ICE 候选对的 ICE 检查列表状态。

规范

规范
WebRTC 统计 API 的标识符
# dom-rtcicecandidatepairstats-state

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。