RTCSessionDescription: RTCSessionDescription() Konstruktor
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
Der RTCSessionDescription() Konstruktor erstellt eine neue RTCSessionDescription mit ihren Eigenschaften, die wie im angegebenen Objekt beschrieben initialisiert sind.
Hinweis:
Dieser Konstruktor ist veraltet, da RTCPeerConnection.setLocalDescription() und andere Methoden, die SDP als Eingabe verwenden, nun direkt ein Objekt akzeptieren, das die Eigenschaften type und sdp enthält. Daher ist es nicht mehr notwendig, eine RTCSessionDescription selbst zu instanziieren.
Syntax
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 neuenRTCSessionDescriptionObjekts festzulegen. Muss einer der gültigenRTCSessionDescription.typeWerte sein. sdpOptional-
Ein String, der eine SDP Nachricht beschreibt, die die Sitzung beschreibt. Dieser Wert ist standardmäßig ein leerer String (
"") und darf nichtnullsein.
Beispiel
Dieses Beispiel verwendet den Konstruktor, um ein SDP-Angebot in ein RTCSessionDescription Objekt umzuwandeln.
Hinweis:
Dies ist jedoch nicht mehr notwendig; RTCPeerConnection.setLocalDescription() und andere Methoden, die SDP als Eingabe verwenden, akzeptieren jetzt direkt einfache Objekte, sodass es nicht erforderlich ist, eine RTCSessionDescription selbst zu instanziieren.
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
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-sessiondescription |