RTCPeerConnectionIceErrorEvent: address 属性

RTCPeerConnectionIceErrorEvent 属性 address 是一个字符串,指示在协商期间用于与 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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。