RTCIceCandidateStats
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
Das RTCIceCandidateStats
Wörterbuch der WebRTC API wird verwendet, um Statistiken zu einem RTCIceCandidate
zu berichten.
Die Statistiken können abgerufen werden, indem über den RTCStatsReport
iteriert wird, der von RTCPeerConnection.getStats()
zurückgegeben wird, bis Sie einen Bericht mit dem type
local-candidate
finden.
Instanz-Eigenschaften
address
Optional-
Ein String, der die Adresse des Kandidaten enthält. Dieser Wert kann eine IPv4-Adresse, eine IPv6-Adresse oder ein vollständiger Domänenname sein. Diese Eigenschaft wurde früher
ip
genannt und akzeptierte nur IP-Adressen. candidateType
-
Ein String, der einen der Werte in
RTCIceCandidate.type
entspricht und angibt, für welche Art von Kandidaten das Objekt Statistiken liefert. deleted
Optional-
Ein Boolescher Wert, der angibt, ob der Kandidat freigegeben oder gelöscht wurde; der Standardwert ist
false
. Bei lokalen Kandidaten ist der Werttrue
, wenn der Kandidat gelöscht oder freigegeben wurde. Bei Host-Kandidaten bedeutettrue
, dass alle mit dem Kandidaten verbundenen Netzwerkressourcen (in der Regel ein Netzwerk-Socket) bereits freigegeben wurden. Bei TURN-Kandidaten ist die TURN-Zuweisung für gelöschte Kandidaten nicht mehr aktiv. Diese Eigenschaft ist für entfernte Kandidaten nicht vorhanden. port
Optional-
Die vom Kandidaten verwendete Netzwerkportnummer.
priority
Optional-
Die Priorität des Kandidaten, entsprechend
RTCIceCandidate.priority
. protocol
Optional-
Ein String, der das Protokoll (
tcp
oderudp
) angibt, das zur Datenübertragung auf demport
verwendet wird. relayProtocol
Optional-
Ein String, der das Protokoll identifiziert, das von der Endstelle zur Kommunikation mit dem TURN-Server verwendet wird; gültige Werte sind
tcp
,udp
undtls
. Nur für lokale Kandidaten vorhanden. transportId
-
Ein String, der das Transportobjekt eindeutig identifiziert, das untersucht wurde, um die zugehörigen
RTCTransportStats
des Kandidaten zu erhalten. url
Optional-
Für lokale Kandidaten ist die
url
-Eigenschaft die URL des ICE-Servers, von dem der Kandidat empfangen wurde. Diese URL stimmt mit derjenigen imRTCPeerConnectionIceEvent
-Objekt überein, das dasicecandidate
-Ereignis darstellt, das den Kandidaten zum lokalen Peer geliefert hat.
Gemeinsame Instanz-Eigenschaften
Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam.
id
-
Ein String, der das Objekt eindeutig identifiziert, das überwacht wird, um diesen Satz von Statistiken zu erzeugen.
timestamp
-
Ein
DOMHighResTimeStamp
-Objekt, das den Zeitpunkt angibt, zu dem die Probe für dieses Statistikobjekt genommen wurde. type
-
Ein String mit dem Wert
"local-candidate"
, der den Typ der Statistiken angibt, die das Objekt enthält.
Beispiele
TBD
Spezifikationen
Specification |
---|
Identifiers for WebRTC's Statistics API # dom-rtcstatstype-local-candidate |
Browser-Kompatibilität
BCD tables only load in the browser