RTCPeerConnection: remoteDescription Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2017 browserübergreifend verfügbar.
Die remoteDescription-Eigenschaft des RTCPeerConnection-Interfaces ist schreibgeschützt und gibt eine RTCSessionDescription zurück, die die Sitzung beschreibt (einschließlich Konfigurations- und Medieninformationen) für das entfernte Ende der Verbindung. Wenn dies noch nicht gesetzt wurde, ist es null.
Der zurückgegebene Wert spiegelt typischerweise eine entfernte Beschreibung wider, die über den Signalisierungsserver empfangen wurde (entweder als Angebot oder als Antwort) und dann in Kraft gesetzt wird, indem Ihr Code RTCPeerConnection.setRemoteDescription() aufruft, um darauf zu reagieren.
Wert
Auf einer grundlegenderen Ebene ist der zurückgegebene Wert der Wert von RTCPeerConnection.pendingRemoteDescription, wenn diese Eigenschaft nicht null ist; ansonsten wird der Wert von RTCPeerConnection.currentRemoteDescription zurückgegeben. Siehe Pending und aktuelle Beschreibungen auf der WebRTC-Konnektivitätsseite für Details zu diesem Algorithmus und warum er verwendet wird.
Beispiel
Dieses Beispiel betrachtet die remoteDescription und zeigt eine Warnmeldung mit den Feldern type und sdp des RTCSessionDescription-Objekts an.
const pc = new RTCPeerConnection();
// …
const sd = pc.remoteDescription;
if (sd) {
alert(`Remote session: type='${sd.type}'; sdp description='${sd.sdp}'`);
} else {
alert("No remote session yet.");
}
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-peerconnection-remotedescription |