RTCIceCandidate：relatedPort 属性

RTCIceCandidate 接口的 relatedPort 只读属性指示中继候选者或反射候选者的端口号。

如果候选者是主机候选者（即其 address 实际上是远程对等端的真实 IP 地址），则 relatedPort 为 null。

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

ICE 本身根本不使用关联地址（relatedAddress）和关联端口；它们仅用于分析和诊断的目的，并且可能会被安全系统阻止（获取），因此不要对它们的非空值有所依赖。

值

一个无符号 16 位整数，表示候选者关联端口。对于对等端和服务器反射候选者，关联地址和关联端口是该服务器或对等端反射候选者的基础。对于中继候选者，关联地址和关联端口设置为 TURN 服务器选择的映射地址。

对于主机候选者，relatedPort 为 null，这意味着该字段未包含在候选者的属性行中。

使用说明

ICE 本身不使用关联地址和关联端口，仅用于诊断和服务质量目的。实际上，出于安全原因，它们可能会被省略，但如果存在的话，在调试过程中可以成为一个有用的工具。请查看示例，其展示了其中的一部分。

下面是由 STUN 服务器发现的 ICE 候选者的 SDP 属性行描述：

a=candidate:4234997325 1 udp 2043278322 192.0.2.172 6502 typ srflx raddr 198.51.100.45 rport 32768 generation 0

远程关联端口 relatedPort，是文本 "rport" 后面的整数，本例中 relatedPort 的值为 32768。

示例

在这个例子中，首先检查了候选者的类型（type），然后基于候选者类型调试输出候选者类型、候选者地址（ ip 和端口）以及关联地址（relatedAddress 和 relatedPort）。

js
const ip = candidate.ip;
const port = candidate.port;
const relIP = candidate.relatedAddress;
const relPort = candidate.relatedPort;

if (relIP && relPort) {
  console.log(
    `候选者类型“${type}”——联系地址：${ip} ${port}，关联地址：${relIP} ${relPort}`,
  );
} else {
  console.log(`主机候选者的地址为 ${ip} ${port}`);
}

规范

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

浏览器兼容性

BCD tables only load in the browser

参见