RTCIceTransport: getRemoteCandidates() 方法
RTCIceTransport 介面的 getRemoteCandidates() 方法返回一個數組,該陣列包含在當前 ICE 收集會話中,迄今為止從遠端對等方收到的每個候選者對應的一個 RTCIceCandidate 物件。
每當您的信令程式碼呼叫 RTCPeerConnection.addIceCandidate() 將收到的候選者新增到 ICE 會話時,ICE 代理就會將其放入此函式返回的列表中。
語法
js
getRemoteCandidates()
引數
無。
返回值
一個數組,包含在當前 ICE 候選者收集會話中,迄今為止從遠端對等方收到的每個候選者對應的一個 RTCIceCandidate 物件。
重要的是要記住,無法將這些遠端候選者與相容的本地候選者相關聯。要查詢迄今為止找到的最佳匹配項,請呼叫 RTCIceTransport.getSelectedCandidatePair()。
示例
這個簡單的示例從 RTCPeerConnection 的第一個 RTCRtpSender 獲取 RTCIceTransport 的遠端候選者列表,然後將列表中的所有候選者輸出到控制檯。
js
const remoteCandidates = pc
.getSenders()[0]
.transport.transport.getRemoteCandidates();
remoteCandidates.forEach((candidate, index) => {
console.log(`Candidate ${index}: ${candidate.candidate}`);
});
規範
| 規範 |
|---|
| WebRTC:瀏覽器中的即時通訊 # dom-rtcicetransport-getremotecandidates |
瀏覽器相容性
載入中…