RTCPeerConnection: remoteDescription 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 remoteDescription schreibgeschützte Eigenschaft des RTCPeerConnection Interfaces gibt eine RTCSessionDescription zurück, die die Sitzung (einschließlich Konfigurations- und Medieninformationen) für die entfernte Seite der Verbindung beschreibt. Wenn dies noch nicht gesetzt wurde, ist dies null.

Der zurückgegebene Wert spiegelt typischerweise eine entfernte Beschreibung wider, die über den Signalisierungsserver empfangen wurde (entweder als Angebot oder Antwort) und dann durch Ihren Code durch Aufruf von RTCPeerConnection.setRemoteDescription() als Reaktion in Kraft gesetzt wurde.

Wert

Auf fundamentalerer Ebene ist der zurückgegebene Wert der Wert von RTCPeerConnection.pendingRemoteDescription, wenn diese Eigenschaft nicht null ist; andernfalls wird der Wert von RTCPeerConnection.currentRemoteDescription zurückgegeben. Siehe Ausstehende und aktuelle Beschreibungen auf der WebRTC-Konnektivitätsseite für Details zu diesem Algorithmus und dessen Gebrauch.

Beispiel

Dieses Beispiel betrachtet die remoteDescription und zeigt einen Alarm an, der die Felder type und sdp des RTCSessionDescription Objekts enthält.

js
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

Specification
WebRTC: Real-Time Communication in Browsers
# dom-peerconnection-remotedescription

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch