RTCPeerConnectionIceErrorEvent: address 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

RTCPeerConnectionIceErrorEventaddress 屬性是一個字串,表示在協商期間用於與 STUNTURN 伺服器通訊的本地 IP 地址。發生的錯誤涉及此地址。

一個字串,指定發生錯誤時正在進行協商的 ICE 伺服器的網路連線的本地 IP 地址。此地址標識了本地裝置上正在使用的網路介面,該介面正用於嘗試建立與遠端對等體的連線。

這在多宿主系統(具有多個網路連線的裝置)上可能很有用,可以確定正在使用哪個網路介面。例如,在手機上,通常至少有兩個可用的網路介面:蜂窩網路連線和 Wi-Fi 連線。

如果本地 IP 地址未作為本地候選者的一部分公開,則 address 的值為 null

示例

此示例建立了一個 icecandidateerror 事件的處理程式,該處理程式會建立人類可讀的訊息,描述連線的本地網路介面以及用於嘗試開啟連線的 ICE 伺服器,然後呼叫一個函式來顯示這些訊息以及事件的 errorText 屬性的內容。

js
pc.addEventListener("icecandidateerror", (event) => {
  let networkInfo = `[Local interface: ${event.address}:${event.port}`;
  let iceServerInfo = `[ICE server: ${event.url}`;

  showMessage(errorText, iceServerInfo, networkInfo);
});

規範

規範
WebRTC:瀏覽器中的即時通訊
# dom-rtcpeerconnectioniceerrorevent-address

瀏覽器相容性