RTCSessionDescription: RTCSessionDescription() Konstruktor

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Der RTCSessionDescription()-Konstruktor erstellt eine neue RTCSessionDescription mit ihren Eigenschaften, die wie im angegebenen Objekt beschrieben initialisiert sind.

Hinweis: Dieser Konstruktor wurde veraltet, da RTCPeerConnection.setLocalDescription() und andere Methoden, die SDP als Eingabe verwenden, jetzt direkt ein Objekt akzeptieren, das die Eigenschaften type und sdp enthält, sodass Sie kein RTCSessionDescription selbst instanziieren müssen.

Syntax

js
new RTCSessionDescription(options)

Werte

options

Ein Objekt, das die Standardwerte für die Sitzungsbeschreibung bereitstellt. Es sollte die folgenden Eigenschaften enthalten:

type

Erforderlich. Ein String, der verwendet wird, um die type-Eigenschaft des neuen RTCSessionDescription-Objekts festzulegen. Muss einer der gültigen RTCSessionDescription.type Werte sein.

sdp Optional

Ein String, der eine SDP-Nachricht beschreibt, die die Sitzung beschreibt. Dieser Wert ist standardmäßig ein leerer String ("") und darf nicht null sein.

Beispiel

Dieses Beispiel verwendet den Konstruktor, um ein SDP-Angebot in ein RTCSessionDescription-Objekt zu konvertieren.

Hinweis: Das ist jedoch nicht mehr notwendig; RTCPeerConnection.setLocalDescription() und andere Methoden, die SDP als Eingabe verwenden, akzeptieren jetzt direkt einfache Objekte, sodass Sie kein RTCSessionDescription selbst instanziieren müssen.

js
navigator.getUserMedia({ video: true }, (stream) => {
  pc.onaddstream({ stream });
  // Adding a local stream won't trigger the onaddstream callback
  pc.addStream(stream);

  pc.createOffer((offer) => {
    pc.setLocalDescription(
      new RTCSessionDescription(offer),
      () => {
        // send the offer to a server to be forwarded to the friend you're calling.
      },
      error,
    );
  }, error);
});

Spezifikationen

No specification found

No specification data found for api.RTCSessionDescription.RTCSessionDescription.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch