RTCPeerConnection: aktuelleRemoteDescription-Eigenschaft
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.
Die schreibgeschützte Eigenschaft currentRemoteDescription
des RTCPeerConnection
-Interfaces gibt ein RTCSessionDescription
-Objekt zurück, das das Ende der Verbindung auf der Gegenseite beschreibt, wie es zuletzt erfolgreich ausgehandelt wurde, seitdem das RTCPeerConnection
das Verhandeln und Verbinden mit einem entfernten Peer abgeschlossen hat.
Ebenfalls enthalten ist eine Liste aller ICE-Kandidaten, die möglicherweise bereits vom ICE-Agenten generiert wurden, seit das durch die Beschreibung dargestellte Angebot oder die Antwort erstmals instanziiert wurde.
Um die currentRemoteDescription
zu ändern, rufen Sie RTCPeerConnection.setRemoteDescription()
auf, was eine Reihe von Ereignissen auslöst, die dazu führen, dass dieser Wert gesetzt wird.
Einzelheiten darüber, was genau passiert und warum die Änderung nicht unbedingt sofort erfolgt, finden Sie unter Ausstehende und aktuelle Beschreibungen auf der Seite zur WebRTC-Konnektivität.
Hinweis: Im Gegensatz zu RTCPeerConnection.remoteDescription
repräsentiert dieser Wert den tatsächlichen aktuellen Zustand des lokalen Endes der Verbindung;
remoteDescription
kann eine Beschreibung angeben, die im Moment im Prozess des Umschaltens ist.
Wert
Die aktuelle Beschreibung des Endes der Verbindung auf der Gegenseite, falls eine gesetzt wurde.
Wenn keine erfolgreich gesetzt wurde, ist dieser Wert null
.
Beispiele
Dieses Beispiel betrachtet die currentRemoteDescription
und zeigt eine Warnung an, die die Felder type
und sdp
des RTCSessionDescription
-Objekts enthält.
const pc = new RTCPeerConnection();
// ...
const sd = pc.currentRemoteDescription;
if (sd) {
alert(`Local session: type='${sd.type}'; sdp description='${sd.sdp}'`);
} else {
alert("No local session yet.");
}
Spezifikationen
Specification |
---|
WebRTC: Real-Time Communication in Browsers # dom-peerconnection-currentremotedesc |
Browser-Kompatibilität
BCD tables only load in the browser