RTCIceTransport: getSelectedCandidatePair() 方法
getSelectedCandidatePair() 方法是 RTCIceTransport 介面的一個方法,它返回一個 RTCIceCandidatePair 物件,該物件包含當前最優的 ICE 候選對,描述了傳輸端點的配置。
語法
js
getSelectedCandidatePair()
引數
無。
返回值
一個 RTCIceCandidatePair 物件,描述了當前選定候選對的兩個端點的配置。 local 描述了連線本地端點的配置,而 remote 描述了遠端對等方的配置。
如果尚未選擇任何候選對,則返回值將是 null。
用法說明
當 ICE 代理程式執行 RTCPeerConnection 的協商時,它會從兩個對等方收集和分析候選配置。一旦找到滿足連線要求的可接受的匹配候選對,就會在 RTCIceTransport 上觸發一個 selectedcandidatepairchange 事件。從那時起,透過呼叫 getSelectedCandidatePair() 即可始終獲得最佳匹配的候選對。
隨著 ICE 協商的繼續,任何時候發現比當前選定對更優的候選對時,都會選擇新的對,替換之前的配對,並再次觸發 selectedcandidatepairchange 事件。
注意: 在選擇新的配對時,選定候選對中的一個配置可能保持不變。
示例
有關示例程式碼,請參閱 RTCIceTransport.onselectedcandidatepairchange。
規範
| 規範 |
|---|
| WebRTC:瀏覽器中的即時通訊 # dom-rtcicetransport-getselectedcandidatepair |
瀏覽器相容性
載入中…