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

瀏覽器相容性