RTCIceCandidate:protocol 属性

RTCIceCandidate 接口的 protocol 只读属性是一个用于指示候选者使用的传输协议是 UDP 还是 TCP 的字符串。

protocol 字段的值是通过传递给 RTCIceCandidate(candidateInfo) 构造函数的 candidateInfo 选项对象中设置的。你不能直接在选项对象中指定 protocol 的值,如果对象的 candidate 属性行(a-line)的格式正确,其值将自动从中提取。

如果在 SDP 中未正确指定 protocol,则 protocol 默认为 null。如果没有设置,在调用 RTCPeerConnection.addIceCandidate() 时将抛出异常。

指示候选者使用的网络协议的字符串:

tcp

如果选择 tcp,该候选者将使用 TCP 作为其数据的传输协议。tcpType 属性提供有关对象表示的 TCP 候选者类型的附加信息。

udp

该候选者将使用 UDP 传输协议进行数据传输。由于其更好的性能特点,是媒体交互的首选协议。

备注: 如果 protocolnull,且用户代理支持 protocol,则将 candidate 传递给 addIceCandidate() 将失败,抛出 OperationError 异常。

使用说明

以下是 ICE 发送的候选者属性行的示例:

a=candidate:4234997325 1 udp 2043278322 192.0.2.172 44323 typ host

第三个字段 "udp" 是协议类型,表示候选者将使用 UDP 传输协议。

示例

此代码片段检查 protocol 的值以决定是否应查看 tcpType 的值,以查看它是否是同时打开(simultaneous-open,S-O)候选者。

js
if (candidate.protocol === "tcp") {
  if (candidate.tcpType === "so") {
    adjustForSimultaneousOpen(candidate);
  }
}

规范

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcicecandidate-protocol

浏览器兼容性

BCD tables only load in the browser