RTCIceTransport: phương thức getSelectedCandidatePair()
Khả dụng hạn chế
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức getSelectedCandidatePair() của giao diện RTCIceTransport trả về một đối tượng RTCIceCandidatePair chứa cặp ứng cử viên ICE lựa chọn tốt nhất hiện tại, mô tả cấu hình của các điểm cuối của truyền tải.
Cú pháp
getSelectedCandidatePair()
Tham số
Không có.
Giá trị trả về
Một đối tượng RTCIceCandidatePair mô tả cấu hình của hai điểm cuối của cặp ứng cử viên hiện đang được chọn.
local mô tả cấu hình của đầu cục bộ của kết nối, trong khi remote mô tả cấu hình của đối tác từ xa.
Giá trị trả về là null nếu chưa có cặp ứng cử viên nào được chọn.
Ghi chú sử dụng
Khi tác nhân ICE thực hiện thương lượng của một RTCPeerConnection, nó thu thập và phân tích các cấu hình ứng cử viên từ mỗi hai đối tác.
Ngay khi tìm thấy một cặp ứng cử viên phù hợp có thể chấp nhận được, đáp ứng các yêu cầu cho kết nối, sự kiện selectedcandidatepairchange được kích hoạt trên RTCIceTransport.
Từ thời điểm đó trở đi, cặp ứng cử viên phù hợp tốt nhất sẽ luôn có sẵn bằng cách gọi getSelectedCandidatePair().
Khi thương lượng ICE tiếp tục, bất kỳ khi nào tìm thấy một cặp ứng cử viên tốt hơn cặp hiện đang được chọn, cặp mới được chọn, thay thế cặp trước đó, và sự kiện selectedcandidatepairchange được kích hoạt lại.
Note: Có thể một trong các cấu hình trong cặp ứng cử viên đã chọn vẫn không thay đổi khi một cặp mới được chọn.
Ví dụ
Xem RTCIceTransport.onselectedcandidatepairchange để biết mã ví dụ.
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcicetransport-getselectedcandidatepair |