WebRTC
RTCIceCandidate 接口的 protocol 只读属性是一个用于指示候选者使用的传输协议是 UDP 还是 TCP 的字符串。
protocol 字段的值是通过传递给 RTCIceCandidate.RTCIceCandidate 构造函数的 candidateInfo 选项对象中设置的。你不能直接在选项对象中指定 protocol 的值,如果对象的 candidate 属性行(a-line)的格式正确,其值将自动从中提取。
如果在 SDP 中未正确指定 protocol,则 protocol 默认为 null。如果没有设置,在调用 RTCPeerConnection.addIceCandidate() 时将抛出异常。
值
指示候选者使用的网络协议的字符串:
tcp- : 如果选择
tcp,该候选者将使用 TCP 作为其数据的传输协议。RTCIceCandidate.tcpType 属性提供有关对象表示的 TCP 候选者类型的附加信息。
- : 如果选择
udp- : 该候选者将使用 UDP 传输协议进行数据传输。由于其更好的性能特点,是媒体交互的首选协议。
[!NOTE] 如果
protocol为null,且user agent支持protocol,则将candidate传递给 RTCPeerConnection.addIceCandidate 将失败,抛出OperationError异常。
使用说明
以下是 ICE 发送的候选者属性行的示例:
a=candidate:4234997325 1 udp 2043278322 192.0.2.172 44323 typ host
第三个字段 "udp" 是协议类型,表示候选者将使用 UDP 传输协议。
示例
此代码片段检查 protocol 的值以决定是否应查看 RTCIceCandidate.tcpType 的值,以查看它是否是同时打开(simultaneous-open,S-O)候选者。
if (candidate.protocol === "tcp") {
if (candidate.tcpType === "so") {
adjustForSimultaneousOpen(candidate);
}
}
规范
浏览器兼容性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
