RTCIceCandidate: port 屬性

Baseline 2024
新推出

自 2024 年 5 月以來,此功能已在最新裝置和瀏覽器版本中可用。此功能可能不適用於較舊的裝置或瀏覽器。

RTCIceCandidate 介面的只讀屬性 port 包含在 RTCIceCandidate.address 給出的地址上,候選對端可以到達的裝置上的埠號。

port 欄位的值是從傳遞給 RTCIceCandidate() 建構函式的 candidateInfo 選項物件設定的。你不能直接在選項物件中指定 port 的值,但如果 candidate a-line 格式正確,它的值會自動從該物件的 candidate a-line 中提取。

一個 16 位數字,表示在 address 指示的地址上,候選對端可以到達的裝置上的埠號。

如果 port 未在 candidate 中指定,或者 candidate 字串無法正確解析,則 port 初始化為 null

注意:如果 portnull,則將候選物件傳遞給 addIceCandidate() 將會失敗,並丟擲 OperationError 異常。這僅適用於實現 port 的候選。

用法說明

考慮這個描述 ICE 候選的 SDP 屬性行(a-line):

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

埠號在第六個欄位中找到,該欄位為 "44323"。在這種情況下,port 的值為 44323。

示例

此程式碼片段獲取候選的 IP 地址和埠號,並將它們儲存在物件中以供將來使用。

js
const candidateLoc = {
  address: candidate.ip,
  port: candidate.port,
};

規範

規範
WebRTC:瀏覽器中的即時通訊
# dom-rtcicecandidate-port

瀏覽器相容性