RTCIceTransport: phương thức getLocalCandidates()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức getLocalCandidates() của giao diện RTCIceTransport trả về một mảng các đối tượng RTCIceCandidate, mỗi đối tượng cho một trong các ứng cử viên đã được thiết bị cục bộ thu thập trong phiên tác nhân ICE hiện tại.

Các ứng cử viên cục bộ được tác nhân ICE đặt vào danh sách này trước khi được gửi đến mã của máy khách cục bộ trong sự kiện icecandidate để máy khách có thể chuyển tiếp các ứng cử viên đến đối tác từ xa.

Cú pháp

js
getLocalCandidates()

Tham số

Không có.

Giá trị trả về

Một Array JavaScript chứa một đối tượng RTCIceCandidate cho mỗi ứng cử viên đã được xác định cho đến nay trong phiên thu thập ứng cử viên ICE.

Bạn không thể tương quan các ứng cử viên cục bộ này với các ứng cử viên từ xa tương ứng. Để tìm cặp phù hợp tốt nhất đến nay, hãy gọi RTCIceTransport.getSelectedCandidatePair().

Ví dụ

Ví dụ đơn giản này lấy danh sách ứng cử viên cục bộ từ RTCIceTransport cho RTCRtpSender đầu tiên trên RTCPeerConnection, sau đó xuất ra bảng điều khiển tất cả các ứng cử viên trong danh sách.

js
const localCandidates = pc
  .getSenders()[0]
  .transport.iceTransport.getLocalCandidates();

localCandidates.forEach((candidate, index) => {
  console.log(`Candidate ${index}: ${candidate.candidate}`);
});

Thông số kỹ thuật

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcicetransport-getlocalcandidates

Tương thích trình duyệt