RTCIceCandidate: component-Eigenschaft
Baseline 2024
Neu verfügbar
Seit Mai 2024 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die schreibgeschützte component-Eigenschaft
der RTCIceCandidate-Schnittstelle ist ein String, der angibt, ob der Kandidat ein RTP- oder ein RTCP-Kandidat ist.
Wenn ein Kandidat sowohl RTP als auch RTCP multiplexiert repräsentiert, wird er als ein RTP-Kandidat gemeldet.
Wert
Ein String, der einen der folgenden Werte annimmt:
rtp-
Identifiziert einen ICE-Transport, der für das Real-time Transport Protocol (RTP) oder für RTP, multiplexiert mit dem RTP Control Protocol (RTCP), genutzt wird. RTP ist definiert in RFC 3550. Dieser Wert entspricht dem Komponenten-ID-Feld in der
candidatea-Zeile mit dem Wert 1. rtcp-
Identifiziert einen ICE-Transport, der für RTCP genutzt wird, das in RFC 3550, Abschnitt 6 definiert ist. Dieser Wert entspricht der Komponenten-ID 2.
Nutzungshinweise
Betrachten Sie diese SDP-Attributzeile (a-Zeile):
a=candidate:4234997325 1 udp 2043278322 192.0.2.172 44323 typ host
Dies ist eine ICE-Kandidat a-Zeile, deren foundation
4234997325 ist. Das nächste Feld in der a-Zeile, "1", ist die
Komponenten-ID. Ein Wert von "1" deutet auf RTP hin, was in der
component-Eigenschaft als "rtp" aufgezeichnet wird. Wenn dieser Wert stattdessen
"2" wäre, würde die a-Zeile einen RTCP-Kandidaten beschreiben und
component wäre "rtcp".
Beispiele
Dieses Codebeispiel untersucht den Komponententyp eines Kandidaten und leitet den Kandidaten an verschiedene Handler, abhängig vom Wert, weiter.
if (candidate.component === "rtp") {
handleRTPCandidate(candidate);
} else if (candidate.component === "rtcp") {
handleRTCPCandidate(candidate);
} else {
handleUnknownCandidate(candidate);
}
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcicecandidate-component |