RTCIceCandidateInit - 包含描述 RTCIceCandidate 所需的基本信息
RTCIceCandidateInit
是 WebRTC 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 的定义 |
候选推荐 | 初始定义。 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 支持 | ≤18 | 22 | 不支持 | 支持 | 未知 |
candidate | 支持 | ≤18 | 221 | 不支持 | 支持 | 未知 |
sdpMid | 支持 | ≤18 | 22 | 不支持 | 支持 | 未知 |
sdpMLineIndex | 支持 | ≤18 | 22 | 不支持 | 支持 | 未知 |
usernameFragment | 支持 | ≤18 | 67 | 不支持 | 支持 | 未知 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 未知 | 支持 | 未知 | 支持 | 未知 |
candidate | 支持 | 支持 | 未知 | 支持1 | 未知 | 支持 | 未知 |
sdpMid | 支持 | 支持 | 未知 | 支持 | 未知 | 支持 | 未知 |
sdpMLineIndex | 支持 | 支持 | 未知 | 支持 | 未知 | 支持 | 未知 |
usernameFragment | 支持 | 支持 | 未知 | 67 | 未知 | 支持 | 未知 |
1. 在 Firefox 68 之前,candidate
属性是必需的。 Firefox 68 及更高版本在 2017 年中期的规范更新中使其成为可选。