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.

js
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

Siehe auch