RTCIceCandidate: port-Eigenschaft

Die schreibgeschützte port-Eigenschaft des RTCIceCandidate-Interfaces enthält die Portnummer auf dem Gerät an der durch RTCIceCandidate.address angegebenen Adresse, unter der der Peer des Kandidaten erreicht werden kann.

Der Wert des port-Feldes wird aus dem candidateInfo-Optionsobjekt übernommen, das an den RTCIceCandidate()-Konstruktor übergeben wird. Sie können den Wert von port nicht direkt im Optionsobjekt angeben, aber sein Wert wird automatisch aus der candidate a-line des Objekts extrahiert, wenn diese richtig formatiert ist.

Wert

Ein 16-Bit-Wert, der die Portnummer auf dem Gerät an der durch address angegebenen Adresse angibt, unter der der Peer des Kandidaten erreicht werden kann.

port wird auf null gesetzt, wenn es nicht im candidate angegeben ist oder wenn der candidate-String nicht richtig analysiert werden kann.

Hinweis: Wenn port null ist, schlägt das Übergeben des Kandidaten an addIceCandidate() fehl und löst eine OperationError-Ausnahme aus. Dies gilt nur, wenn der Kandidat port implementiert.

Anwendungshinweise

Betrachten Sie diese SDP-Attributzeile (a-line), die einen ICE-Kandidaten beschreibt:

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

Die Portnummer befindet sich im sechsten Feld, das "44323" lautet. In diesem Fall wird der Wert von port 44323 sein.

Beispiele

Dieses Code-Snippet holt die IP-Adresse und die Portnummer des Kandidaten und speichert sie in einem Objekt zur zukünftigen Verwendung.

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

Spezifikationen

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
port

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support