RTCIceCandidateInit - 包含描述 RTCIceCandidate 所需的基本信息

RTCIceCandidateInitWebRTC API 的字典,其中包含描述 RTCIceCandidate 所需的基本信息。使用 new RTCIceCandidate() 创建新的 ICE 候选对象时,将使用 RTCIceCandidateInit。它也用作 RTCIceCandidate.toJSON() 方法的返回值,并且可以直接传递到 RTCPeerConnection.addIceCandidate() 中,以将候选者添加到对等连接。

属性

candidate 可选

ICE candidate-attribute。如果候选对象指示没有其他候选对象(而不是代表新的候选对象),则为空字符串("")。默认值为空字符串。

sdpMid 可选

与候选者关联的媒体流的标识标签,如果没有关联的媒体流,则为 null。默认值为 null

sdpMLineIndex 可选

与候选者相关联的媒体描述的 SDP 中 m 行的从零开始的索引,如果不存在这样的关联,则为 null。默认值为 null

usernameFragment 可选

一个 DOMString,包含一个唯一标识远程对等方的字符串。该字符串由 WebRTC 在会话开始时生成,并且该字符串中至少有 24 位值包含随机数据。该字符串最长为 256 个字符。该属性没有默认值,除非明确设置,否则没有值。

规范

规范 状态 备注
WebRTC 1.0: Real-time Communication Between Browsers
RTCIceCandidateInit 的定义
候选推荐 初始定义。

桌面浏览器兼容性

特性ChromeEdgeFirefoxInternet ExplorerOperaSafari
基础支持 支持≤1822 不支持 支持 未知
candidate 支持≤18221 不支持 支持 未知
sdpMid 支持≤1822 不支持 支持 未知
sdpMLineIndex 支持≤1822 不支持 支持 未知
usernameFragment 支持≤1867 不支持 支持 未知

移动浏览器兼容性

特性AndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
基础支持 支持 支持 未知 支持 未知 支持 未知
candidate 支持 支持 未知 支持1 未知 支持 未知
sdpMid 支持 支持 未知 支持 未知 支持 未知
sdpMLineIndex 支持 支持 未知 支持 未知 支持 未知
usernameFragment 支持 支持 未知67 未知 支持 未知

1. 在 Firefox 68 之前,candidate 属性是必需的。 Firefox 68 及更高版本在 2017 年中期的规范更新中使其成为可选。