RTCIceCandidatePairStats: state 屬性

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

RTCIceCandidatePairStats 字典的 state 屬性指示該候選對所屬的 checklist 的狀態。

一個字串,其值是以下之一:

failed

已為該候選對執行了檢查但失敗。失敗可能由於未收到響應,或響應表明發生了無法恢復的錯誤。

frozen

尚未為此候選對執行檢查,並且在另一項檢查成功之前,該檢查的執行將被阻止。一旦該檢查成功,該候選對將解凍並進入 waiting 狀態。

in-progress

已為該候選對發起檢查,但檢查的事務仍在進行中。

succeeded

已成功完成對該候選對的檢查。

waiting

尚未檢查此候選對,但一旦此候選對成為 waiting 狀態下剩餘的最高優先順序候選對,即可執行檢查。

描述

ICE 檢查列表

在 ICE 協商期間,ICE 層會構建一個checklist,這是一個潛在的 ICE 候選對列表。每個候選對都有一個狀態,由字串字面量表示。

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

當候選對新增到 checklist 時,它最初處於 frozen 狀態。一旦沒有正在進行的檢查阻止該候選對被分析,它就會被解凍並進入 waiting 狀態。這可能在新增到 checklist 時立即發生。

每次檢查一個候選對時,checklist 中剩餘的下一個最高優先順序的候選對會從 waiting 狀態移至 in-progress 狀態,並開始其檢查。如果由於任何原因檢查失敗,該候選對將進入其最終狀態 failed。如果檢查成功,該候選對將最終處於 succeeded 狀態。任何給定 ICE 候選對的 ICE checklist 狀態可以在相應的 state 屬性中找到。

規範

規範
WebRTC 統計 API 的識別符號
# dom-rtcicecandidatepairstats-state

瀏覽器相容性