RTCPeerConnection: pendingRemoteDescription 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 pendingRemoteDescription schreibgeschützte Eigenschaft der RTCPeerConnection-Schnittstelle gibt ein RTCSessionDescription-Objekt zurück, das eine anstehende Konfigurationsänderung für das entfernte Ende der Verbindung beschreibt.

Dies beschreibt nicht die aktuelle Verbindung, sondern wie sie möglicherweise in naher Zukunft existieren könnte. Verwenden Sie RTCPeerConnection.currentRemoteDescription oder RTCPeerConnection.remoteDescription, um die aktuelle Sitzungsbeschreibung für das entfernte Endpunkt zu erhalten. Für Details zu den Unterschieden siehe Anstehende und aktuelle Beschreibungen auf der WebRTC-Konnektivitätsseite.

Wert

Wenn eine Änderung der Remote-Beschreibung in Bearbeitung ist, handelt es sich um eine RTCSessionDescription, die die vorgeschlagene Konfiguration beschreibt. Andernfalls wird null zurückgegeben.

Beispiele

In diesem Beispiel wird pendingRemoteDescription betrachtet, um festzustellen, ob eine Beschreibung geändert wird.

js
const pc = new RTCPeerConnection();
// …
const sd = pc.pendingRemoteDescription;
if (sd) {
  // There's a description change underway!
} else {
  // No description change pending
}

Spezifikationen

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

Browser-Kompatibilität

Hinweis: Die Aufnahme von pendingRemoteDescription und currentRemoteDescription in die WebRTC-Spezifikation ist relativ neu. In Browsern, die diese nicht unterstützen, ist nur remoteDescription verfügbar.

Siehe auch