RTCIceCandidate: thuộc tính foundation
Baseline
2024
Newly available
Since May 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Thuộc tính chỉ đọc foundation của giao diện RTCIceCandidate là một chuỗi cho phép tương quan các candidate từ một đường mạng chung trên nhiều đối tượng RTCIceTransport.
Các candidate dùng chung foundation nếu chúng:
- có cùng loại: "host", "relayed", "server reflexive" hoặc "peer reflexive".
- có "bases" dùng chung địa chỉ IP và truyền tải, nhưng không nhất thiết cùng cổng. Lưu ý rằng địa chỉ IP là địa chỉ của giao diện mạng mà ICE agent đã gửi candidate từ đó.
- Chúng đến từ máy chủ STUN hoặc TURN có cùng địa chỉ IP.
Thuộc tính này giúp tối ưu hóa hiệu năng ICE khi ưu tiên và tương quan các candidate xuất hiện trên nhiều đối tượng RTCIceTransport.
Giá trị
Một chuỗi xác định duy nhất candidate trên tất cả các RTCIceTransport mà nó có sẵn.
Note:
Nếu port là null và port được user agent hỗ trợ, việc truyền candidate vào addIceCandidate() sẽ thất bại, ném ra ngoại lệ OperationError.
Ghi chú sử dụng
Hãy xem xét dòng thuộc tính SDP (a-line) mô tả một ICE candidate:
a=candidate:4234997325 1 udp 2043278322 192.0.2.172 44323 typ host
Trường "4234997325" là foundation.
Ví dụ
Đoạn mã này dùng foundation của hai candidate để xác định xem chúng có thực sự là cùng một candidate không.
if (candidate1.foundation === candidate2.foundation) {
/* the two candidates are the same, even if they're on
different transports */
}
Thông số kỹ thuật
| Specification |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcicecandidate-foundation |