RTCIceCandidatePairStats: state property
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
Thuộc tính state của từ điển RTCIceCandidatePairStats cho biết trạng thái của danh sách kiểm tra mà cặp ứng viên là thành viên.
Giá trị
Một chuỗi có giá trị là một trong các giá trị sau:
failed-
Đã thực hiện kiểm tra cho cặp này nhưng thất bại. Lỗi có thể xảy ra do không nhận được phản hồi hoặc phản hồi cho biết đã xảy ra lỗi không thể phục hồi.
frozen-
Chưa có kiểm tra nào được thực hiện cho cặp ứng viên này, và việc thực hiện kiểm tra bị chặn cho đến khi một kiểm tra khác thành công. Khi kiểm tra đó thành công, cặp này sẽ được giải phóng và chuyển sang trạng thái
waiting. in-progress-
Đã bắt đầu một kiểm tra cho cặp này, nhưng giao dịch của kiểm tra vẫn đang tiến hành.
succeeded-
Đã hoàn thành thành công kiểm tra cho cặp này.
waiting-
Cặp này chưa được kiểm tra, nhưng kiểm tra có thể được thực hiện ngay khi cặp này là cặp có mức ưu tiên cao nhất còn lại ở trạng thái
waiting.
Mô tả
>Danh sách kiểm tra ICE
Trong quá trình đàm phán ICE, lớp ICE xây dựng một danh sách kiểm tra, là danh sách các cặp ứng viên ICE tiềm năng. Mỗi cặp có một trạng thái, được biểu diễn bằng một chuỗi ký tự.
Khi một cặp ứng viên được thêm vào danh sách kiểm tra, nó bắt đầu ở trạng thái frozen. Ngay khi không có kiểm tra nào đang diễn ra có thể chặn cặp đó được phân tích, nó được giải phóng và chuyển sang trạng thái waiting. Điều này có thể xảy ra ngay lập tức khi được thêm vào danh sách kiểm tra.
Mỗi khi một cặp ứng viên được kiểm tra, cặp ứng viên có mức ưu tiên cao nhất tiếp theo còn lại trong danh sách kiểm tra chuyển từ trạng thái waiting sang trạng thái in-progress, và kiểm tra của nó bắt đầu. Nếu kiểm tra thất bại vì bất kỳ lý do gì, cặp đó chuyển sang trạng thái cuối cùng là failed. Nếu kiểm tra thành công, cặp kết thúc ở trạng thái succeeded. Trạng thái danh sách kiểm tra ICE cho bất kỳ cặp ứng viên ICE nào có thể được tìm thấy trong thuộc tính state tương ứng.
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Identifiers for WebRTC's Statistics API> # dom-rtcicecandidatepairstats-state> |