RTCPeerConnection: currentRemoteDescription 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 currentRemoteDescription Nur-Lese Eigenschaft des RTCPeerConnection Interfaces gibt ein
RTCSessionDescription Objekt zurück, das das Remote-Ende der Verbindung beschreibt, wie es zuletzt erfolgreich verhandelt wurde, seit dem letzten Mal, als die RTCPeerConnection die Verhandlung und Verbindung mit einem externen Partner abgeschlossen hat.
Ebenfalls enthalten ist eine Liste von ICE-Kandidaten, die möglicherweise bereits seit der Erstellung des Angebots oder der Antwort durch den ICE-Agenten generiert wurden, die von der Beschreibung dargestellt wird.
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.
Für Details darüber, was genau passiert und warum die Änderung nicht unbedingt sofort erfolgt, siehe Ausstehende und aktuelle Beschreibungen auf der WebRTC-Konnektivitätsseite.
Hinweis:
Im Gegensatz zu RTCPeerConnection.remoteDescription repräsentiert dieser Wert den tatsächlichen aktuellen Status des lokalen Endes der Verbindung;
remoteDescription kann eine Beschreibung angeben, die die Verbindung derzeit zu übernehmen versucht.
Wert
Die aktuelle Beschreibung des Remote-Endes der Verbindung, falls eine gesetzt wurde.
Falls keine erfolgreich gesetzt wurde, ist dieser Wert null.
Beispiele
Dieses Beispiel betrachtet die currentRemoteDescription und zeigt einen Alarm an, der die type- und sdp-Felder 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 |